home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / logs / plusv3d1 / v3demo_1.exe / REPORTER.DOC < prev    next >
Text File  |  1994-08-13  |  133KB  |  3,249 lines

  1.  
  2.  
  3.   Grumpfish Report Generator                                 LOGPlus! v3.0
  4.  
  5.  
  6.   
  7.   The Report Generator provided with LOGPlus! is provided "AS IS" and
  8.   is "UNSUPPORTED".  This product, other than minor changes to the
  9.   basic code, is a fully function report generator developed by Grumpfish
  10.   Inc. and Greg Lief.  This documentation file is provide "AS IS" and
  11.   will provide basic information which provides the basic operating
  12.   technics of the report generator.  Only slight variations between the 
  13.   commercial product and LOGPlus! Report Generator exists.  Questions 
  14.   and suggestions are encouraged and will be looked into as time permits.  
  15.   Currently, only three databases are supported. (LOGBOOK, SATELLITE and DXCC).
  16.   If additional databases support is requested, they can easily be added.  
  17.   However, unless you obtain the necessary files directly from the BBS, 
  18.   a support change of $4.00 USD is required to cover shipping and handling 
  19.   charges.
  20.   
  21.   NOTICE:  Some slight variations will be noted.  Please use the file
  22.   SAMPLE.DBF as a test as per the documentation listed below.
  23.   
  24.   
  25.   
  26.                           Grumpfish Reporter Version 2.0
  27.                                 User Documentation
  28.                           Copyright (c) 1992-4 Greg Lief
  29.   
  30.   
  31.   ┌──────────────────────────────────────────────────────────────────────────┐
  32.   │ You may integrate the contents of this file into your own system         │
  33.   │ documentation, provided that you prominently display the Grumpfish, Inc. │
  34.   │ copyright notice as stated in this paragraph.  You may display this      │
  35.   │ copyright notice either at the beginning of the system documentation or  │
  36.   │ at the beginning of that particular section.  Suggested wording for      │
  37.   │ these two locations would be: (a) "Portions of this documentation are    │
  38.   │ Copyright (c) 1992-3 Grumpfish, Inc."; or (b) "The following section of  │
  39.   │ documentation is Copyright (c) 1992-3 Grumpfish, Inc."                   │
  40.   └──────────────────────────────────────────────────────────────────────────┘
  41.   
  42.   Contents
  43.   
  44.   I.    BASIC OPERATION
  45.   II.   QUICK START PART ONE
  46.   III.  QUICK START PART TWO
  47.   IV.   COMMAND-LINE PARAMETERS
  48.   V.    FILES MENU
  49.   VI.   QUERY MENU
  50.   VII.  OUTPUT MENU
  51.   VIII. DATA DICTIONARY MENU
  52.   IX.   GLOBALS MENU
  53.   
  54.   ------------------------------------------------------------------------
  55.   
  56.  
  57.  
  58.                                     -1-                                   
  59.  
  60.  
  61.   Grumpfish Report Generator                                 LOGPlus! v3.0
  62.  
  63.  
  64.   I.    BASIC OPERATION
  65.   
  66.   Grumpfish Reporter is built around a framework of "menus". A menu is a
  67.   series of options for you to select from.  For example, when you first
  68.   fire up Grumpfish Reporter, the main menu will contain the options
  69.   "File", "Query", "Output", "Data Dictionary", and "Globals".  Whenever a
  70.   menu is active on-screen, you can make a selection in one of several
  71.   ways: (a) using the arrow keys to move the highlight bar to the desired
  72.   option and pressing Enter; or (b) pressing the highlighted trigger
  73.   letter.  For the main menu, the first letter of each option serves as
  74.   the trigger letter, though this will not always be the case.
  75.   
  76.   To open a submenu, select a main menu option by one of the two options
  77.   listed above.  To close a submenu, press Esc.  In general, you press Esc
  78.   to return to the previous menu.
  79.   
  80.   TIP: There is a third way to select menu options shown on some of the
  81.   Grumpfish Reporter submenus: "Quick Keys".  For example, press "F" from
  82.   the main menu to open the Files submenu. This submenu contains three
  83.   options for you to select from.  Notice that each of these options has a
  84.   "quick key" associated it -- for example, Alt-X is the quick key for the
  85.   Exit option.  Any of these quick keys are active anywhere from within
  86.   the structure of the Grumpfish Reporter main menu.  You can try this now
  87.   by pressing ESC to close the Files submenu, then press Alt-X from the
  88.   main menu.  Surprise -- you'll be at the operating system before you
  89.   know what hit you.
  90.   
  91.   While the menu is helpful as you become familiar with Grumpfish
  92.   Reporter, knowledge of these quick keys can ultimately save you a lot of
  93.   time getting around in the program.
  94.   
  95.   For your convenience, the names of the currently active report, query,
  96.   and data dictionary will be shown at the bottom of the main menu screen.
  97.   
  98.   
  99.   II.   QUICK START PART ONE
  100.   
  101.   We have supplied a sample database (appropriately named SAMPLE.DBF)
  102.   on your Grumpfish Reporter diskette.  Let's draw up a sample report
  103.   with the following information:
  104.   
  105.   We want a printout of all articles containing the word "Review" in their
  106.   title.  We want to show the author, title, date, and number of pages for
  107.   each of these articles.  We want thist list to be sorted by author
  108.   first, and then title.  We also want to know the total number of pages
  109.   for all of these articles, as well as the average number of pages per
  110.   article.
  111.   
  112.   Move to the directory where Grumpfish Reporter resides (assuming you
  113.   followed the installation instructions, that should be the \REPORTER
  114.  
  115.  
  116.                                     -2-                                   
  117.  
  118.  
  119.   Grumpfish Report Generator                                 LOGPlus! v3.0
  120.  
  121.  
  122.   directory).  Fire it up by typing "GR" (or "GR /M" if you are using a
  123.   monochrome monitor).  Sample DOS instructions to perform this might be:
  124.   
  125.   C:>CD\REPORTER
  126.   C:\REPORTER>GR
  127.   
  128.   a) Opening The File
  129.   
  130.   Our first step is to open the database we want to query/report on.
  131.   
  132.   1. The "Files" option should be highlighted.  Press Enter to open the
  133.   Files submenu.
  134.   
  135.   2. The first option on this submenu, "Open", will be highlighted. Press
  136.   Enter to select that.
  137.   
  138.   3. You will then be presented with a list of DBF files for selection,
  139.   among which should be SAMPLE.DBF.  Use the arrow keys or PgDn to move
  140.   the highlight bar to SAMPLE.DBF, and press Enter.
  141.   
  142.   4. Since we do not need to open any related files for this example,
  143.   press Enter.  You will be presented with the message "Are you finished
  144.   selecting files?" -- press Enter again.
  145.   
  146.   b) Selecting Fields to be Displayed
  147.   
  148.   Our next step is to determine which fields should be shown as part of
  149.   the output.
  150.   
  151.   1. You should now be at the "Query" submenu.  The first option on that
  152.   submenu, "Display Fields", will be highlighted.  Press Enter to select
  153.   it.
  154.   
  155.   2. You will see a list of selected fields on the right side of the
  156.   screen.  Because we only want to look at a few of these fields, press
  157.   F10 to remove all selected fields.
  158.   
  159.   3. We want to see the author's name, title, date, and pages.  The
  160.   Spacebar is used to select fields, which moves them from the left window
  161.   (available) to the right window (selected). Use the arrow keys to move
  162.   the highlight bar to the Author field, and press Spacebar to select it.
  163.   
  164.   4. Repeat step 3 for the Title and Date fields.
  165.   
  166.   5. But when you get to Pages, remember that we want to see the total and
  167.   average number of pages for all articles.  Because Pages is numeric
  168.   data, you will be presented with a list of possible numeric formulae to
  169.   choose from.
  170.   
  171.   6. Use Spacebar to tag "Total" and "Average", then press Enter.
  172.  
  173.  
  174.                                     -3-                                   
  175.  
  176.  
  177.   Grumpfish Report Generator                                 LOGPlus! v3.0
  178.  
  179.  
  180.   
  181.   7. Press ESC to exit back to the Query submenu.
  182.   
  183.   c) Selecting a Sort Order
  184.   
  185.   Our next step is to establish a "sort order". This will determine the
  186.   order in which we view the data.
  187.   
  188.   1. Use the down arrow to highlight the "Sort Order" option and press
  189.   Enter.
  190.   
  191.   2. You will be presented with a window similar to that for the Display
  192.   Fields, except that nothing will have been selected.
  193.   
  194.   3. We want to see the data sorted by author, then title.  Make sure that
  195.   the Author field is highlighted and press the Spacebar.  It will move
  196.   from the left side to the right side.
  197.   
  198.   4. Repeat this process for the Title field.
  199.   
  200.   5. Once again, press ESC to return to the previous menu.  A message
  201.   will appear reminding you that, to activate your sort order, you must
  202.   first "execute" the query. We will get to that shortly. In the meantime,
  203.   feel free to press the Spacebar to make that message vanish faster.
  204.   
  205.   d) Selecting a Query Condition
  206.   
  207.   Our next step is to create a query condition, which allows us to look at
  208.   a subset of the entire file.
  209.   
  210.   1. Use the Down arrow to highlight the "Condition" option, and press
  211.   Enter.
  212.   
  213.   2. You will see four choices along the bottom row of the screen.  The
  214.   first option, "Add Condition", is highlighted and that is the one you
  215.   want, so press Enter.
  216.   
  217.   3. You will be given the list of fields to select from.  Remember that
  218.   we only wanted to look at articles that contained the word "Review" in
  219.   their title.  Therefore, our query condition will be based on the TITLE
  220.   field.  Use the Down arrow to highlight that field and press Enter.
  221.   
  222.   4. You will then be presented with a list of operators.  The one we want
  223.   is "contains", because we are looking for titles that contain the word
  224.   "REVIEW".  Use the down arrow (or press "C") to highlight "contains",
  225.   and press Enter.
  226.   
  227.   5. You will be prompted to enter what you want the TITLE field to
  228.   contain.  Type in "REVIEW" (in either upper- or lower-case) and press
  229.   Enter.
  230.  
  231.  
  232.                                     -4-                                   
  233.  
  234.  
  235.   Grumpfish Report Generator                                 LOGPlus! v3.0
  236.  
  237.  
  238.   
  239.   6. Press "X" or ESC to exit from this window back to the Query submenu.
  240.   
  241.   e) Executing the Query
  242.   
  243.   As mentioned above, whenever you change the sort order and/or query
  244.   condition, you will get a reminder that "To activate this Query, select
  245.   EXECUTE...". It is indeed time to execute this query. This will re-order
  246.   your database based upon both the query condition and the sort order
  247.   steps that we just performed.
  248.   
  249.   1. Press the down arrow to highlight the "Execute Query" option, and
  250.   press Enter.  A status bar will appear in the middle of the screen
  251.   showing you the progress of this action. When this is finished, you will
  252.   be moved automatically to the Output menu.
  253.   
  254.   2. Just to make sure that everything is fine, let's view the data on
  255.   the screen before we print it out.  The "View" option is the first
  256.   option on the Output menu.  It should already be highlighted, so go
  257.   ahead and press Enter.  You will be presented with a browse window
  258.   containing exactly the data you specified. Use the arrow keys to move
  259.   through the data, and press ESC when you are finished browsing.
  260.   
  261.   f) Getting a Hard Copy
  262.   
  263.   The end result of this work is to get a hard copy of the data.  But
  264.   before we do that, we need to install a printer.  (I hope you have a
  265.   printer that supports compressed print, because we'll need that for this
  266.   particular report due to the column widths.)
  267.   
  268.   1. Press the right arrow twice to move to the "Globals" submenu.
  269.   
  270.   2. Press Enter for "Printer Setup", then highlight "Select Printer" and
  271.   press Enter again.
  272.   
  273.   3. You will be given a list of available printers to select from. To
  274.   find your printer, you can use the up or down arrows, PgUp, and PgDn
  275.   keys.  A faster method is to type in the first few letters of your
  276.   printer's name.  For example, if you have an HP Laserjet, press "HP" to
  277.   jump immediately to that group of printers.  Once you have located your
  278.   printer, press Enter to install it.
  279.   
  280.   4. You will now be asked to enter a printer description and port. Your
  281.   description should be anything that helps you to identify that
  282.   particular printer. For example, if your office has three HP Laserjets,
  283.   then you might want to refer to them like "Joe's Printer", "Accounting
  284.   Department", and "Personnel Department".
  285.   
  286.   Ports that Grumpfish Reporter supports are LPT1, LPT2, LPT3, COM1, COM2,
  287.   COM3, and COM4. The most common printer port is LPT1, so go ahead and
  288.  
  289.  
  290.                                     -5-                                   
  291.  
  292.  
  293.   Grumpfish Report Generator                                 LOGPlus! v3.0
  294.  
  295.  
  296.   select that (there's a 99% chance that it will work in your situation).
  297.   
  298.   5. Great!  You've installed your printer.  Now press "S" to save
  299.   global/printer information.  By doing so, the next time you enter
  300.   Grumpfish Reporter you will not have to re-install your printer.
  301.   
  302.   6. Now press the left arrow twice to move back to the "Output" menu.
  303.   Press the down arrow to highlight the "Printer" option and press
  304.   Enter.
  305.   
  306.   7. You will be asked several questions about your printed output. The
  307.   first question is whether you want to review your print options, which
  308.   include the header and footer.  Answer "NO" to this question.  (We'll
  309.   discuss this in greater detail later in this manual.)
  310.   
  311.   8. Your next decision is where to send the output: printer, file, or
  312.   screen.  Make sure that "Printer" is highlighted and press Enter.  You
  313.   will then be asked to verify that the printer is on-line and ready.
  314.   Make sure it is, then highlight "Ready" and press Enter.  You'll see the
  315.   status bar, and when that's finished, so is your report!
  316.   
  317.   g) Saving Our Report for Next Time
  318.   
  319.   The last thing we'll do before we exit Grumpfish Reporter is save a copy
  320.   of our report specification.  This is composed of the various pieces of
  321.   the report, including the list of fields, the sort order, and the query
  322.   condition.  You can also add other things, like a report header and
  323.   footer, but we will not get into those until the next Quick Start
  324.   discussion.  We want to save a copy of this report so that we do not
  325.   have to go through the trouble of recreating it.
  326.   
  327.   1. You should still be on the "Output" submenu.  Look for the "Save
  328.   Report" option near the bottom.  Rather than using the arrow keys, this
  329.   time just press "S" to select this option.
  330.   
  331.   2. You will be first asked to enter a description.  Your description may
  332.   be up to 60 characters long. Give this report the description "Reviews
  333.   sorted by author and title". Press Enter when you are finished typing
  334.   the description.
  335.   
  336.   3. You will then be asked to enter a filename, which may be up to 8
  337.   characters long. Let's use "SAMPLE1" as the name for this report. The
  338.   ".GRR" file extension will be added automatically.  The message "Saving
  339.   Report" should appear briefly, then disappear.
  340.   
  341.   4. Now we can exit Grumpfish Reporter -- press ESC twice to get the "Are
  342.   you sure you want to exit" message. Make sure the "Yes" is highlighted,
  343.   and press Enter to bid the program a fond (but surely temporary) adieu.
  344.   
  345.   III.  QUICK START PART TWO
  346.  
  347.  
  348.                                     -6-                                   
  349.  
  350.  
  351.   Grumpfish Report Generator                                 LOGPlus! v3.0
  352.  
  353.  
  354.   
  355.   This time, let's refine our output somewhat.  We need to get a count of
  356.   records by author, which is easily done but something we did not bother
  357.   with last time.  We will investigate the report header and footer so
  358.   that you can get a better feel for how to change those items.  We will
  359.   also change our query condition slightly and save it.  Finally, we need
  360.   to create a spreadsheet containing our information.
  361.   
  362.   a) Fire It Up
  363.   
  364.   Start up Grumpfish Reporter by moving to the directory where it resides.
  365.   
  366.   b) Reload Your Report
  367.   
  368.   Repeat the steps you followed earlier to open SAMPLE.DBF. Then move to
  369.   the Output menu and press "L" for Load Report. (You can also use the
  370.   Alt-R quick key to accomplish this from anywhere in Grumpfish Reporter.)
  371.   You'll be given a list of available reports.  There will probably only
  372.   be one -- that which you just saved.  Press Enter to load it.
  373.   
  374.   The message "Loading Report" will appear on the screen, and your query
  375.   will be processed to properly reflect your query condition and sort
  376.   order.
  377.   
  378.   TIP: Whenever you fire up Reporter and plan to reload a previously saved
  379.   report, you can use option is to use the /R command-line parameter. This
  380.   tells Grumpfish Reporter to reload a saved report immediately. For our
  381.   example, you would type the following command to reload your report:
  382.   
  383.   C>GR /RSAMPLE1
  384.   
  385.   Not only will this reload the report in SAMPLE1.GRR, but it will also
  386.   cause the SAMPLE.DBF database to be opened at the same time... no muss,
  387.   no fuss!
  388.   
  389.   c) Changing Print Options
  390.   
  391.   With the exception of the spreadsheet, all of our work is going to
  392.   revolve around the Print Options section.  This is accessible either
  393.   when you are preparing to print a report, or from the Globals submenu.
  394.   We will go ahead and print another hard copy, so we can access the Print
  395.   Options as part of that process.
  396.   
  397.   1. Press "P" to select "Printer".  You will be presented with the
  398.   question: "Review print options?".  Press "Y" for Yes.
  399.   
  400.   2. The Print Options window is divided into three sections: Printer
  401.   Options, Header Information, and Footer Information. You may press the
  402.   Tab key to move quickly between each of the sections. We will look at
  403.   the Printer Options section first.
  404.  
  405.  
  406.                                     -7-                                   
  407.  
  408.  
  409.   Grumpfish Report Generator                                 LOGPlus! v3.0
  410.  
  411.  
  412.   
  413.   i) Printer Options
  414.   
  415.   The first item is Page Length.  If you are using a laser printer, you
  416.   should probably change this to 60.
  417.   
  418.   Left and Top margins should be self-explanatory.  Left Margin can be
  419.   between 1 and 49.  Top Margin can be between 1 and 19.  The default
  420.   settings for these margins are 5 and 0, respectively.
  421.   
  422.   If you answer yes to "Print total records?", that will simply cause the
  423.   total number of records to be printed at the end of your report. (By
  424.   default, this information is not printed.)
  425.   
  426.   If you are using a sort order, you may wish to answer yes to "Eject
  427.   after subgroups". This will cause each new subgroup to be printed on a
  428.   new page. (By default, this is not the case.)
  429.   
  430.   "Column Spacing" is the number of spaces to separate each of the columns
  431.   on your report.  The default spacing is 1, and you can increase this as
  432.   high as 19 if you wish.
  433.   
  434.   "Suppress Duplicate Values?" can be a confusing question.  To answer it,
  435.   here are two examples of not suppressing, and then suppressing,
  436.   duplicate values.  Watch the Author name column to see the effect.
  437.   
  438.   Not Suppressing Duplicate Values
  439.   
  440.   Author                 Title
  441.   ---------------------- --------------------------------------------------
  442.   Darren Forcier         REVIEW UPDATE: Overlay Version 3.5
  443.   Darren Forcier         REVIEW: Blinker - Dynamic Overlay Linker
  444.   Darren Forcier         REVIEW: Class(y)
  445.   Darren Forcier         REVIEW: Desqview Clipper API
  446.   Darren Forcier         REVIEW: The Force Compiler
  447.   Joe Booth              REVIEW: Data Junction
  448.   Joe Booth              REVIEW: Rad - Rapid Application Development
  449.   Steve Baker            REVIEW: FlexFile
  450.   Steve Baker            REVIEW: Telepathy
  451.   
  452.   Suppressing Duplicate Values
  453.   
  454.   Author                 Title
  455.   ---------------------- --------------------------------------------------
  456.   Darren Forcier         REVIEW UPDATE: Overlay Version 3.5
  457.                          REVIEW: Blinker - Dynamic Overlay Linker
  458.                          REVIEW: Class(y)
  459.                          REVIEW: Desqview Clipper API
  460.                          REVIEW: The Force Compiler
  461.   Joe Booth              REVIEW: Data Junction
  462.  
  463.  
  464.                                     -8-                                   
  465.  
  466.  
  467.   Grumpfish Report Generator                                 LOGPlus! v3.0
  468.  
  469.  
  470.                          REVIEW: Rad - Rapid Application Development
  471.   Steve Baker            REVIEW: FlexFile
  472.                          REVIEW: Telepathy
  473.   
  474.   Many people prefer to suppress duplicate values for aesthetic purposes,
  475.   though you are certainly free to choose whatever method you prefer.
  476.   
  477.   "Show Record Count For Subgroups" is one of the options we need to
  478.   change.  By answering Yes to this question, Grumpfish Reporter will
  479.   automatically give us the number of records printed for each subgroup
  480.   based on the primary sort order.  This would result in printed output
  481.   similar to the following:
  482.   
  483.   Author                 Title
  484.   ---------------------- --------------------------------------------------
  485.   Darren Forcier         REVIEW UPDATE: Overlay Version 3.5
  486.                          REVIEW: Blinker - Dynamic Overlay Linker
  487.                          REVIEW: Class(y)
  488.                          REVIEW: Desqview Clipper API
  489.                          REVIEW: The Force Compiler
  490.   'Darren Forcier': Count = 5
  491.   
  492.   Joe Booth              REVIEW: Data Junction
  493.                          REVIEW: Rad - Rapid Application Development
  494.   'Joe Booth': Count = 2
  495.   
  496.   Steve Baker            REVIEW: FlexFile
  497.                          REVIEW: Telepathy
  498.   'Steve Baker': Count = 2
  499.   
  500.   "Double-spaced output" allows you to specify that the report be printed
  501.   double-spaced. This is a requirement for some people, which is why we
  502.   have included it as an option. (Default output is single-spaced.)
  503.   
  504.   "Show % of total for subgroups" is similar to record count for
  505.   subgroups. If you answer Yes to this question, the database will be
  506.   scanned prior to printing the report to determine the total number of
  507.   records. Then the percentage of records represented by each
  508.   subgroup will be printed at the end of the subgroup. The following example
  509.   demonstrates this:
  510.   
  511.   Author                 Title
  512.   ---------------------- --------------------------------------------------
  513.   Darren Forcier         REVIEW UPDATE: Overlay Version 3.5
  514.                          REVIEW: Blinker - Dynamic Overlay Linker
  515.                          REVIEW: Class(y)
  516.                          REVIEW: Desqview Clipper API
  517.                          REVIEW: The Force Compiler
  518.   Darren Forcier:  55.55% of total
  519.   
  520.  
  521.  
  522.                                     -9-                                   
  523.  
  524.  
  525.   Grumpfish Report Generator                                 LOGPlus! v3.0
  526.  
  527.  
  528.   Joe Booth              REVIEW: Data Junction
  529.                          REVIEW: Rad - Rapid Application Development
  530.   Joe Booth: 22.22% of total
  531.   
  532.   Steve Baker            REVIEW: FlexFile
  533.                          REVIEW: Telepathy
  534.   Steve Baker: 22.22% of total
  535.   
  536.   If you answer Yes to the "Summary report only" question, this will only
  537.   print one line for each sort key, along with any counts and percentages.
  538.   Summary reports can be useful if you only care about the record count for
  539.   each subgroup. The following listing demonstrates a summary report, with
  540.   subgroup counts and percentages.
  541.   
  542.   Author                 Title
  543.   ---------------------- --------------------------------------------------
  544.   Darren Forcier:  Count = 5
  545.   Darren Forcier:  55.55% of total
  546.   
  547.   Joe Booth:  Count = 2
  548.   Joe Booth: 22.22% of total
  549.   
  550.   Steve Baker:  Count = 2
  551.   Steve Baker: 22.22% of total
  552.   
  553.   "Auto-compress" determines whether Grumpfish Reporter will force your
  554.   printer to compressed mode for reports wider than 80 columns (110
  555.   columns for landscape, 140 columns for landscape legal).  By default,
  556.   auto-compress is turned on. However, you might want to turn it off if
  557.   you have a printer that will accommodate wide paper.  Naturally, this
  558.   feature will not do anything if your printer doesn't support compressed
  559.   mode.
  560.   
  561.   "Printer port" determines the port to which to send the report. As
  562.   mentioned previously, Grumpfish Reporter supports LPT1-3 and COM1-4.
  563.   
  564.   There are four other options that may appear in this first section
  565.   depending upon the type of printer you are using.
  566.   
  567.   a) If you are using a laser printer, you will be given the option of
  568.   changing the page orientation.  "P" is Portrait, which is standard 8
  569.   1/2" width, 11" length.  "L" is Landscape, which is 11" width, 8 1/2"
  570.   length.
  571.   
  572.   b) If you have a printer that supports legal size paper, you can specify
  573.   that by answering Yes to the "Legal" question. (By default, letter size
  574.   will be used.)
  575.   
  576.   c) If you have a printer that supports A4 size paper, you can use that
  577.   by answering Yes to the "A4" question. (By default, letter size will be
  578.  
  579.  
  580.                                     -10-                                  
  581.  
  582.  
  583.   Grumpfish Report Generator                                 LOGPlus! v3.0
  584.  
  585.  
  586.   used.)
  587.   
  588.   d) If you have a printer that supports 8 lines per inch, you will be given
  589.   the option of switching between 6 and 8 LPI.  8 LPI allows you to squash
  590.   more data onto the printed page (at the potential risk of losing your
  591.   eyesight when you attempt to read it).
  592.   
  593.   d) Changing Header and Footer
  594.   
  595.   The next two sections of this window are devoted to Header and
  596.   Footer Information, respectively.  The header and footer are each
  597.   composed of four lines.  Each of those four lines is divided into
  598.   three sections: Left, Center, and Right.  Items in the Left section
  599.   will be printed flush against the left margin.  Items in the Center
  600.   section will be centered horizontally on the row.  Items in the Right
  601.   section will be printed flush against the right margin.
  602.   
  603.   These items can contain either stock insertion items or actual text.
  604.   For your convenience, we have included a variety of stock insertion
  605.   items (including date, time, company name, and report description) that
  606.   you would not necessarily want to have to re-type each time you prepared
  607.   a report. You can also insert database fields in the header and/or footer.
  608.   
  609.   The default report header is comprised of the following:
  610.   
  611.   Line 1:   Date (flush left), Company Name (centered), Page # (flush right)
  612.   Line 2:   Time (flush left)
  613.   
  614.   All four of these are stock insertion items.  You can insert these
  615.   (and other similar items) anywhere you like in the header or footer.
  616.   
  617.   1. Let's make a few changes to the header now.  Move the cursor to the
  618.   Header Line 2/Center item, which should currently be blank.  We want
  619.   to insert the report description here.
  620.   
  621.   2. Press F10.  You will be presented with a list of insertion options.
  622.   Move the highlight bar down to REPORT_DESC (Report Description) and
  623.   select Enter. This will cause the report description to be printed
  624.   centered on the second row of each page header.
  625.   
  626.   3. Just after Line 4, you will see the item "Lines between header and
  627.   column headings".  This specifies the buffer to use between the report
  628.   header and the column headings.  By default, this will be one blank
  629.   space, though you can increase it to as many as 9.
  630.   
  631.   4. The footer should currently be completely empty.  Let's have a
  632.   one-line footer that shows the current date flush left, current page #
  633.   centered, and current time flush right.
  634.   
  635.   5. Place the cursor in the Footer Line 1/Left item.  Press F10 for the
  636.  
  637.  
  638.                                     -11-                                  
  639.  
  640.  
  641.   Grumpfish Report Generator                                 LOGPlus! v3.0
  642.  
  643.  
  644.   list of insertion options and press Enter to select the date.
  645.   
  646.   6. Move the cursor to the Footer Line 1/Center item.  Type in a hyphen
  647.   ("-") followed by a space.  Press F10 again for the list of insertion
  648.   options.  Use the down arrow to highlight the Page option and press
  649.   Enter to select it.  Then type in another space and a hyphen.  This will
  650.   print the page number like so: "- 1 -", "- 2 -", etcetera.
  651.   
  652.   7. Move the cursor to the Footer Line 1/Right item.  Press F10 once
  653.   again for the insertion options, press the down arrow once to
  654.   highlight Time, and press Enter to select it.
  655.   
  656.   8. Press PgDn to save your changes.
  657.   
  658.   At this point you may wish to save the report again so that you will not
  659.   have to recreate the header and footer.
  660.   
  661.   Before moving on, get another hard copy so that you can see the effect
  662.   of the subgroup counts and the header/footer changes you made.
  663.   
  664.   Whenever you change print options, the new settings will remain in
  665.   effect until you either load a previously saved report or change the
  666.   options again.
  667.   
  668.   
  669.   e) Modifying Query
  670.   
  671.   Our current query condition is all articles that contain the word
  672.   "REVIEW" as part of their title.  Let's modify this so that we only look
  673.   at reviews that deal with communications products.  There is another
  674.   field entitled KEYWORDS, which will serve us well here.
  675.   
  676.   1. Move to the Query submenu.  Press "C" for "Condition".
  677.   
  678.   2. You will see your original condition on the right side of the screen.
  679.   Press "A" to add another condition.
  680.   
  681.   3. You will first need to specify whether this new condition will relate
  682.   to the previously existing condition(s).  If you select "AND", that
  683.   means that both the previous condition and the new one must be fulfilled
  684.   in order for a record to be part of your query.  If you select "OR",
  685.   that means that either the previous condition or the new one need be
  686.   fulfilled.  You can see that the difference between "AND" and "OR" is
  687.   very important.  Select "AND" and press Enter.
  688.   
  689.   4. Highlight the KEYWORDS fields with the down arrow and press Enter.
  690.   
  691.   5. Press "C" to highlight the "Contains" option and press Enter.
  692.   
  693.   6. Type in "COMMUNICATION" and press Enter.
  694.  
  695.  
  696.                                     -12-                                  
  697.  
  698.  
  699.   Grumpfish Report Generator                                 LOGPlus! v3.0
  700.  
  701.  
  702.   
  703.   7. Press "X" or ESC to exit back to the previous submenu.
  704.   
  705.   f) Saving Query
  706.   
  707.   Before you execute this new query, let's save it for future use.
  708.   
  709.   1. You should still be on the Query submenu.  Press "S" for Save Query.
  710.   
  711.   2. You will be first asked to enter a description.  Your description may
  712.   be up to 60 characters long. Give this query the description "Communication
  713.   product reviews". Press Enter when you are finished typing the
  714.   description.
  715.   
  716.   3. You will then be asked to enter a filename, which may be up to 8
  717.   characters long.  Let's use "COMMPROD" as the name for this query. The
  718.   ".GRQ" file extension will be added automatically.  The message "Saving
  719.   Query" should appear briefly, then disappear.
  720.   
  721.   You can then re-load this query later if you want to look at this
  722.   particular subset of records.
  723.   
  724.   g) Spreadsheet Output
  725.   
  726.   1. Move to the "Output" submenu.  Press "Q" for Quattro/Lotus/Excel
  727.   output.
  728.   
  729.   2. You will be asked to specify which type of spreadsheet you wish
  730.   Grumpfish Reporter to produce.  These include: Lotus 2.x, Lotus 3.x,
  731.   Quattro, Quattro Pro, Excel 2, Excel 3, and Excel 4.  Highlight the
  732.   desired spreadsheet type and press Enter.
  733.   
  734.   3. You will then be asked to enter a filename, which may be up to 8
  735.   characters long.  Let's use "COMMPROD" again as the name for this
  736.   spreadsheet. The appropriate worksheet file extension will be added
  737.   automatically.
  738.   
  739.   4. You will be asked if you wish the cells to be protected.  This
  740.   applies to once the spreadsheet has been loaded into Lotus, Quattro, or
  741.   Excel. Answer Yes or No.
  742.   
  743.   5. The status bar will then appear to keep you apprised of the progress
  744.   of the file creation.  When the status bar is full, the creation is
  745.   finished.  You can then retrieve this file from DOS or Windows and use
  746.   it with your spreadsheet program.
  747.   
  748.   
  749.   DETAILS DETAILS DETAILS
  750.   
  751.   The remainder of this manual is devoted to discussing the many Grumpfish
  752.  
  753.  
  754.                                     -13-                                  
  755.  
  756.  
  757.   Grumpfish Report Generator                                 LOGPlus! v3.0
  758.  
  759.  
  760.   Reporter features in greater detail.  This will be divided by menu
  761.   (Files, Query, etc), because the menus form natural logical groupings.
  762.   You can read these sections all at once if you so desire, although we
  763.   recommend that you instead refer to specific sections of concern as
  764.   necessary.
  765.   
  766.   
  767.   IV.   COMMAND-LINE PARAMETERS
  768.   
  769.   Grumpfish Reporter can be executed with the following command-line
  770.   parameters:
  771.   
  772.   /DEV              Allow creation/editing of data dictionaries
  773.   
  774.   /M -or- /MONO     Monochrome operation
  775.   
  776.   /R<reportname>    Specify a pre-saved report to be loaded automatically
  777.   
  778.   /Q<queryname>     Specify a pre-saved query to be loaded automatically
  779.   
  780.   /D<datadictname>  Specify a pre-saved data dictionary to be loaded
  781.                     automatically
  782.   
  783.   If you use more than one command-line parameter, be sure to separate
  784.   them with spaces.
  785.   
  786.   Most of the items on the data dictionary menu are only available to
  787.   someone with high enough security (either an administrator or
  788.   developer).  The /DEV command-line parameter would be used in those
  789.   situations where you want to create a data dictionary for use by other
  790.   users.  We do not recommend that you make this particular command-line
  791.   parameter common knowledge, because some users will not be adept enough
  792.   to create data dictionaries.
  793.   
  794.   
  795.   SECURITY LEVEL
  796.   
  797.   There are many Grumpfish Reporter features that would simply confuse the
  798.   average user. Therefore, many of these features are tied directly to
  799.   security level. The primary reason for this design is to avoid
  800.   overcomplicating the life of the average user.
  801.   
  802.   There are five basic security levels:
  803.   
  804.   - None
  805.   - Average
  806.   - Power User
  807.   - Administrator
  808.   - Developer
  809.   
  810.  
  811.  
  812.                                     -14-                                  
  813.  
  814.  
  815.   Grumpfish Report Generator                                 LOGPlus! v3.0
  816.  
  817.  
  818.   We already discussed under "Command-Line Parameters" how to activate
  819.   Grumpfish Reporter with Developer level security. More specific
  820.   information of these security levels will appear during the Data
  821.   Dictionary section, because each data dictionary can have its own
  822.   security level. In the meantime, though, there may be occasional mention
  823.   of security level in the following discussions, which is why we are
  824.   outlining it now.
  825.   
  826.   
  827.   V.    FILES MENU
  828.   
  829.   The Files menu is the simplest of all the menus.  It contains three
  830.   options: "Open", "Exit", and "DOS".
  831.   
  832.   a) Open
  833.   
  834.   The "Open" option allows you to open one or more database files to use
  835.   for your query and report.  The quick key associated with this menu
  836.   option is F2.
  837.   
  838.   You will be presented with a list of DBF files for selection.  Use the
  839.   arrow keys or PgDn to move the highlight bar to the desired file and press
  840.   Enter to select it.  You may also type in the first few letters of the
  841.   filename to jump quickly to that file.  If you need to see the field
  842.   structure of a DBF file, highlight the file in question and press F9.
  843.   
  844.   If the current directory has no DBF files, or if the file you wish to
  845.   use is in a different directory, you can step backwards through the
  846.   directory tree structure by highlighting the parent directory entry
  847.   (shown by double periods) and pressing Enter.  All items in this window
  848.   that are bracketed by "<" and ">" indicate subdirectory entries.
  849.   
  850.   If the file you wish to use in on an entirely different drive, press the
  851.   F10 key to switch drives.
  852.   
  853.   Once you have selected a file, you will presented with a completely
  854.   different window that has three columns for Parent, Children, and
  855.   Grandchildren databases.  If you need to open related files, this screen
  856.   clearly shows you the hierarchy between those files.
  857.   
  858.   While you are in this window, you can continue to open more files.
  859.   Let's assume that you have opened a parent database named ORDERS.DBF.
  860.   You want to open two child files related to ORDERS: CUSTOMERS.DBF and
  861.   VENDORS.DBF.  With the highlight bar on ORDERS.DBF, press INS.  This
  862.   will open the file picklist window for you to choose from. Look for the
  863.   desired file and press Enter to select it.  Once you have done so, you
  864.   will be presented with another window to establish a relationship
  865.   between the parent and child databases.
  866.   
  867.   Highlight the appropriate field (in this case, VENDOR_NO) and press
  868.  
  869.  
  870.                                     -15-                                  
  871.  
  872.  
  873.   Grumpfish Report Generator                                 LOGPlus! v3.0
  874.  
  875.  
  876.   Enter.  Grumpfish Reporter will scan the child file for fields that
  877.   match the one you just selected.  If there is at least one such matching
  878.   field, you will get another selection window.  If there are no matching
  879.   fields, you will get an error message to that effect and will have to
  880.   pick a different field from the parent file.
  881.   
  882.   Once you have properly established the relationship between the parent
  883.   and child database, the relationship will be shown in the main window.
  884.   A line will be drawn between the parent and child, and the link field
  885.   will be shown in parentheses between the two filenames. To move around
  886.   within this window, use the arrow keys.  You may continue to add related
  887.   databases to the parent or one of the child databases.
  888.   
  889.   You may also remove files by highlighting them and pressing DEL.
  890.   Whenever you delete a file, all files related to it and lower on the
  891.   general hierarchy will be deleted as well.  For example, if you delete
  892.   the parent file, all other files will be deleted along with it.
  893.   
  894.   When you are finished selecting files, press Enter twice.  This will
  895.   open the files you have selected in the proper relationship hierarchy.
  896.   At this time, Grumpfish Reporter will create temporary index files for
  897.   all databases that have been related to others.
  898.   
  899.   b) Exit
  900.   
  901.   The "Exit" option allows you to exit Grumpfish Reporter. The quick key
  902.   associated with this menu option is Alt-X.
  903.   
  904.   c) DOS
  905.   
  906.   The "DOS" option allows you to temporarily exit Grumpfish Reporter to
  907.   DOS. The quick key associated with this menu option is Alt-F10.  When
  908.   you make use of this option, you will have approximately the same amount
  909.   of free memory available as just prior to loading Grumpfish Reporter.
  910.   This means that you could create a spreadsheet from within Grumpfish
  911.   Reporter, then temporarily exit to run Quattro or Lotus to review the
  912.   spreadsheet.
  913.   
  914.   When you use the "DOS" option, your DOS prompt will be altered to remind
  915.   you that you are still inside Grumpfish Reporter:
  916.   
  917.   On temporary hiatus from Grumpfish Reporter
  918.   Press EXIT at any prompt to return to G.R.
  919.   C:\REPORTER>
  920.   
  921.   TIP: Unlike all other menu quick-keys, which are only available in
  922.   framework of the Main Menu, Alt-F10 for the DOS option is available
  923.   for your convenience ANYWHERE within Grumpfish Reporter.
  924.   
  925.   
  926.  
  927.  
  928.                                     -16-                                  
  929.  
  930.  
  931.   Grumpfish Report Generator                                 LOGPlus! v3.0
  932.  
  933.  
  934.   VI.   QUERY MENU
  935.   
  936.   The Query menu contains the following options: "Display Fields", "Sort
  937.   Order", "Condition", "Execute Query", "Load Query", "Save Query", "Clear
  938.   Query", and "Delete Query".
  939.   
  940.   a) Display Fields
  941.   
  942.   The "Display Fields" option allows you to select the fields that you
  943.   wish to see as part of your report or output.  The quick key associated
  944.   with this menu option is F3.
  945.   
  946.   When you select this option, you will be presented with two lists of
  947.   fields on the left and right side of the screen.  The fields shown on
  948.   the left are still available for selection.  Those shown on the right
  949.   have already been selected for display.
  950.   
  951.   To select a field for display, highlight it with the arrow keys and
  952.   press Spacebar.
  953.   
  954.   To remove the last field selected for display, press Backspace.
  955.   
  956.   To remove all fields selected for display, press F10.
  957.   
  958.   To return to the previous submenu, press Esc.  You may return to this
  959.   menu option at any time to change the fields being displayed.
  960.   
  961.   If you select a numeric field, you will be given a list of numeric
  962.   formulae that may be attached to that field for output purposes. These
  963.   include: Totals, Subtotals, Average, Maximum, Minimum, Deviation, and
  964.   Variance. You can toggle individual formulae on and off by highlighting
  965.   them and pressing Spacebar. You may also turn on all formulae by
  966.   pressing F8, or turn off all formulae by pressing F9. When you are
  967.   finished selecting numeric formulae, press Enter to proceed.
  968.   
  969.   NOTE: When you open a file using the Files menu, all fields will
  970.   automatically be selected for display.  When you are using a data
  971.   dictionary, no fields will initially be selected, and you will have to
  972.   select them manually.
  973.   
  974.   TIP: If no fields are currently selected, you may select all of them by
  975.   pressing F10.
  976.   
  977.   b) Sort Order
  978.   
  979.   The "Sort Order" option allows you to determine the order in which you
  980.   will view your data.  The quick key associated with this menu option is
  981.   F4.
  982.   
  983.   As with "Display Fields", when you select this option you will be
  984.  
  985.  
  986.                                     -17-                                  
  987.  
  988.  
  989.   Grumpfish Report Generator                                 LOGPlus! v3.0
  990.  
  991.  
  992.   presented with two lists of fields on the left and right side of the
  993.   screen.  The fields shown on the left are still available for selection.
  994.   Those shown on the right have already been selected as part of the sort
  995.   order.
  996.   
  997.   To select a field as part of the sort order, highlight it with the arrow
  998.   keys and press Spacebar.  If you wish to use a descending sort on this
  999.   field, press F10 instead of Spacebar.  By default, sorts are ascending
  1000.   (A-Z).  You may combine ascending and descending sorts as part of the
  1001.   same sort order.
  1002.   
  1003.   To remove the last field selected, press Backspace.
  1004.   
  1005.   TIP: You can filter out duplicate sort records by pressing ALT-F. This
  1006.   is similar to a summary report in that your report will only contain the
  1007.   first record for each sort key.
  1008.   
  1009.   To return to the previous submenu, press Esc.  You may return to this
  1010.   menu option at any time to change the sort order.
  1011.   
  1012.   c) Condition
  1013.   
  1014.   The "Condition" option is used to determine which subset of data you
  1015.   want to look at by creating query conditions.  The quick key associated
  1016.   with this menu option is F5.
  1017.   
  1018.   When you select this option, you will see four options along the bottom
  1019.   of the screen: "Add Condition", "Edit Condition", "Delete Condition",
  1020.   and "Exit".  We will run through the steps of adding a new condition
  1021.   before we discussing editing or deleting conditions.
  1022.   
  1023.   A query condition contains the following items:
  1024.   
  1025.   - the field you are querying
  1026.   
  1027.   - an operator (equal to, greater than, etcetera)
  1028.   
  1029.   - a value
  1030.   
  1031.   Press "A" to add a new condition.  You will first be presented with a
  1032.   list of available fields.  Use the arrow keys to highlight the
  1033.   appropriate one, and press Enter. You may also specify a formula
  1034.   by selecting the "<FORMULA>" option at the bottom of the field list.
  1035.   This is useful if, for example, you need to compare two database fields
  1036.   to each other.
  1037.   
  1038.   The next window will contain operators.  Grumpfish Reporter features the
  1039.   following operators:
  1040.   
  1041.   1) is equal to
  1042.  
  1043.  
  1044.                                     -18-                                  
  1045.  
  1046.  
  1047.   Grumpfish Report Generator                                 LOGPlus! v3.0
  1048.  
  1049.  
  1050.   2) is less than
  1051.   3) is greater than
  1052.   4) is less than or equal to
  1053.   5) greater than or equal to
  1054.   6) is not equal to
  1055.   7) is between
  1056.   8) is empty
  1057.   9) is not empty
  1058.   10) contains*
  1059.   11) contains (positional)*
  1060.   12) does not contain*
  1061.   13) begins with*
  1062.   14) ends with*
  1063.   15) sounds like*
  1064.   
  1065.   *Applies to character data only
  1066.   
  1067.   Most of these operators are self-explanatory. However, the positional
  1068.   contains requires further illumination.  It is a pattern-matching device
  1069.   that lets you look for specific characters in specific positions.  You
  1070.   use qusetion marks to block out irrelevant characters.  For example,
  1071.   you want to find all items that have the letters "ABC" in the
  1072.   third through fifth positions. You could use "???ABC" as the matching
  1073.   value.
  1074.   
  1075.   The next window allows you to enter a value for this particular query
  1076.   condition. You can also peek into the database by pressing F2 if you get
  1077.   stuck for what to enter.
  1078.   
  1079.   TIP: If you press F2 for suggested values on a character field, and
  1080.   there is an open index corresponding to that field, you will be able to
  1081.   incrementally search for values by typing the first few letters of what
  1082.   you are looking for.
  1083.   
  1084.   You may press Backspace to go back through any of these three steps
  1085.   (field, operator, value). When you have completed a query condition, it
  1086.   will be shown on the right side of the screen.
  1087.   
  1088.   Boolean Operators/Parentheses
  1089.   
  1090.   When you add subsequent query conditions, you will need to specify
  1091.   a "boolean" operator associated with them.  This will generally amount
  1092.   to selecting either "AND" or "OR".  If you select "AND", that means that
  1093.   both the previous condition AND the new one must be fulfilled in order
  1094.   for a record to be part of your query. If you select "OR", then either
  1095.   the previous condition OR the new one need be fulfilled.
  1096.   
  1097.   If you are operating at a security level of 5 (Power User) or greater,
  1098.   you will also be able to select the options "AND (" and "OR (".  These
  1099.   allow you to nest parentheses as part of your query conditions.
  1100.  
  1101.  
  1102.                                     -19-                                  
  1103.  
  1104.  
  1105.   Grumpfish Report Generator                                 LOGPlus! v3.0
  1106.  
  1107.  
  1108.   Parentheses can be used to override the natural precedence of these two
  1109.   operators. Ordinarily, AND is evaluated prior to OR.
  1110.   
  1111.   Editing Query Conditions
  1112.   
  1113.   You may edit any individual query condition after the fact by selecting
  1114.   the "Edit Condition" option. When you select it, a highlight bar will
  1115.   appear in the query condition window.  Use the arrow keys to highlight
  1116.   the condition you wish to edit, and press Enter. If you change your mind
  1117.   and decide not to edit any conditions, press Esc.
  1118.   
  1119.   Deleting Query Conditions
  1120.   
  1121.   You may delete any individual query condition by selecting the "Delete
  1122.   Condition" option. As with editing conditions, a highlight bar will
  1123.   appear in the query condition window.  Use the arrow keys to highlight
  1124.   the condition you wish to edit, and press Enter. If you change your
  1125.   mind, press ESC to exit without deleting any conditions.
  1126.   
  1127.   d) Execute Query
  1128.   
  1129.   The "Execute Query" option takes your sort order and query condition(s)
  1130.   into account to give you a different view of your database.  This view
  1131.   will be limited to the subset defined by your query condition, shown in
  1132.   the order defined by your sort order.
  1133.   
  1134.   NOTE: Whenever you change the sort order and/or query condition, you
  1135.   must select the "Execute Query" option to reflect those changes.
  1136.   
  1137.   e) Load Query
  1138.   
  1139.   The "Load Query" option allows you to load a previously saved query.
  1140.   The quick key associated with this menu option is Alt-Q.
  1141.   
  1142.   When you select this option, you will be presented with a list of
  1143.   descriptions of previously saved queries (or an error message if there
  1144.   are no queries found), along with the date/time that they were created.
  1145.   Use the arrow key to highlight the one you want, and press Enter.
  1146.   
  1147.   Assuming that it applies to the currently active data dictionary or open
  1148.   files, this query will be executed immediately and thus take effect.
  1149.   
  1150.   f) Save Query
  1151.   
  1152.   The "Save Query" option allows you to save a query for later use.
  1153.   This will save the query condition and sort order, along with a
  1154.   description of the query which you provide.
  1155.   
  1156.   When you select this option, you will be first asked to enter a
  1157.   description.  Your description may be up to 60 characters long. If you
  1158.  
  1159.  
  1160.                                     -20-                                  
  1161.  
  1162.  
  1163.   Grumpfish Report Generator                                 LOGPlus! v3.0
  1164.  
  1165.  
  1166.   decide not to save the query, leave the description empty. Press Enter
  1167.   when you are finished typing the description.
  1168.   
  1169.   You will then be asked to enter a filename, which may be up to 8
  1170.   characters long.  (Again, you can back out of this by leaving the
  1171.   filename empty).  The ".GRQ" file extension will be added automatically.
  1172.   If you enter the name of an existing file, you will be warned that you
  1173.   are about to overwrite it.
  1174.   
  1175.   The message "Saving Query" should appear briefly, then disappear.
  1176.   
  1177.   You can then re-load this query with "Load Query" to look again at this
  1178.   particular subset of records.
  1179.   
  1180.   g) Clear Query
  1181.   
  1182.   The "Clear Query" option allows you to clear the current query
  1183.   conditions.  You will be asked if you wish to proceed with this, and if
  1184.   so, all query conditions will be removed.
  1185.   
  1186.   NOTE: Display fields and sort order will not be cleared.  In fact, if
  1187.   there is an active sort order, the current view will be rebuilt
  1188.   automatically.
  1189.   
  1190.   h) Delete Query
  1191.   
  1192.   The "Delete Query" option allows you to delete a previously saved query
  1193.   file.
  1194.   
  1195.   When you select this option, you will be presented with a list of
  1196.   descriptions of previously saved queries (or an error message if there
  1197.   are no queries found).  Use the arrow key to highlight the query you
  1198.   want to delete, and press Enter.
  1199.   
  1200.   NOTE: Whenever you save a query, the current security level will be
  1201.   saved along with it.  You will only be able to delete that query if you
  1202.   have at least the same security level as the person who created it.
  1203.   
  1204.   VII.  OUTPUT MENU
  1205.   
  1206.   The "Output" menu contains the following options: "View", "Printer",
  1207.   "Form", "Label", "CrossTab", "Database", "Quattro/Lotus/Excel", "ASCII",
  1208.   "Treeducer", "Load Report", "Save Report", "Clear Report", and "Delete
  1209.   Report".
  1210.   
  1211.   a) View
  1212.   
  1213.   The "View" option lets you view the result of your query on-screen prior
  1214.   to committing it to print.  But more importantly, you can also make
  1215.   changes to the layout of the data via this option.  The quick key
  1216.  
  1217.  
  1218.                                     -21-                                  
  1219.  
  1220.  
  1221.   Grumpfish Report Generator                                 LOGPlus! v3.0
  1222.  
  1223.  
  1224.   associated with this menu option is F6.
  1225.   
  1226.   NOTE: This option will only be available when there is at least one
  1227.   field selected for display.
  1228.   
  1229.   When you select this option, you will be presented with a table-style
  1230.   browse of your database(s).  The columns of this table will correspond
  1231.   directly to the Display Fields that you established earlier.  For
  1232.   example, if you picked three display fields -- Name, Title, and Address
  1233.   -- you will have three columns containing those fields.
  1234.   
  1235.   The total number of print columns (i.e., the width of a printed report)
  1236.   will be displayed at all times in the lower right corner of the browse
  1237.   window. This also accounts for any spaces between columns (as determined
  1238.   by the current column spacing setting in the Print Options window).
  1239.   
  1240.   The following active keys apply during the browse:
  1241.   
  1242.   Key             Description
  1243.   Up Arrow        Move up one row of data
  1244.   Down Arrow      Move down one row of data
  1245.   Left Arrow      Move left one column
  1246.   Right Arrow     Move right one column
  1247.   PgDn            Move down one screenful of data
  1248.   PgUp            Move up one screenful of data
  1249.   Ctrl-PgDn       Move to bottom of data
  1250.   Ctrl-PgUp       Move to top of data
  1251.   Home            Jump to start of previous subgroup (requires sort order)
  1252.   End             Jump to start of next subgroup (requires sort order)
  1253.   Ctrl-Home       Pan to first (leftmost) column
  1254.   Ctrl-End        Pan to last (rightmost) column
  1255.   Ctrl-Left       Pan to first (leftmost) column
  1256.   Ctrl-Right      Pan to last (rightmost) column
  1257.   Enter           View memofield (if applicable)
  1258.   /               Open Browse Configuration Menu
  1259.   F2              Show calculations (applies only when the cursor is in a
  1260.                   column containing numeric data that has numeric formulae
  1261.                   attached to it)
  1262.   F3              Show count of total records
  1263.   ESC             Exit
  1264.   
  1265.   Browse Configuration Menu
  1266.   
  1267.   Most of the power of the View option lies in the Browse Configuration
  1268.   Menu. This lets you interactively change the configuration of your data,
  1269.   which in turn can have a drastic effect on the way that it is printed or
  1270.   converted to other file formats.
  1271.   
  1272.   However, like many advanced features of Grumpfish Reporter it is
  1273.   security-driven. The reason is that the average end user will only
  1274.  
  1275.  
  1276.                                     -22-                                  
  1277.  
  1278.  
  1279.   Grumpfish Report Generator                                 LOGPlus! v3.0
  1280.  
  1281.  
  1282.   become confused by this. Therefore, you must have at least Average
  1283.   security for the Browse Configuration Menu to be active.
  1284.   
  1285.   Let's discuss the many options on the Browse Configuration Menu:
  1286.   
  1287.   Column Attributes
  1288.   
  1289.   This opens a submenu containing the following options specific to the
  1290.   current column that you are in:
  1291.   
  1292.   Contents: This allows you to change the contents of the current column.
  1293.   You will be given a list of available fields to serve as the basis for
  1294.   this column. Use the arrow keys to highlight a field and press Enter to
  1295.   select it. You may also select "Formula", in which case you can type in
  1296.   an user-defined formula. A formula can include most standard dBASE III+
  1297.   functions, such as RECNO() and SUBSTR().
  1298.   
  1299.   Header: This allows you to change the header of the current column.
  1300.   You can make the header multiple lines deep by embedding semi-colons
  1301.   indicating line breaks.  To remove the header completely, leave it
  1302.   blank.
  1303.   
  1304.   Width: This enables you to widen or truncate the current column as
  1305.   desired.
  1306.   
  1307.   Column Separator: This allows you to change the separator between the
  1308.   current column and the one to the left of it. (NOTE: This requires at
  1309.   least power user security.) You will be asked to enter the desired
  1310.   column separator, using the tilde ("~") to mark the end. If you need
  1311.   help with the line drawing characters (don't we all?), press F10 for an
  1312.   extremely thorough and helpful chart. These line drawing characters are
  1313.   all denoted with three-digit codes. Type in the code that applies to the
  1314.   character you want, and it will automatically be inserted for you. (See
  1315.   also "Column Separator" under the "Browse Attributes Menu" discussion.)
  1316.   
  1317.   Header Separator: This allows you to change the separator between the
  1318.   current column header and the data in that column. (NOTE: This requires
  1319.   at least power user security.) If you change a column separator, you
  1320.   will probably need to change the corresponding header separator to
  1321.   ensure that the vertical lines join properly.  As with column
  1322.   separators, each header separator goes between the current column and
  1323.   the one to the left of it. You will be asked to enter the desired header
  1324.   separator, using the tilde ("~") to mark the end. Also as with column
  1325.   separators, you can press F10 for the line drawing character chart. (See
  1326.   also "Header Separator" under the "Browse Attributes Menu" discussion.)
  1327.   
  1328.   PICTURE Clause: This allows you to attach a dBASE-style PICTURE clause
  1329.   to character or numeric data. Here are some PICTURE templates and
  1330.   characters at your disposal:
  1331.   
  1332.  
  1333.  
  1334.                                     -23-                                  
  1335.  
  1336.  
  1337.   Grumpfish Report Generator                                 LOGPlus! v3.0
  1338.  
  1339.  
  1340.   @B   Display numbers left-justified
  1341.   @C   Display "CR" after positive numbers
  1342.   @R   Insert non-template characters (for example, @R (###) ###-####)
  1343.   @X   Display "DB" after negative numbers
  1344.   @Z   Display zeros as blanks
  1345.   @!   Convert alphabetic characters to upper-case
  1346.   @(   Enclose negative numbers in parentheses
  1347.   $    Display a dollar sign in place of leading space in number
  1348.   *    Display an asterisk in place of leading space in number
  1349.   
  1350.   You may combine templates (i.e., items preceded by "@").  For example,
  1351.   "@C@X" will display "CR" after positive numbers and "DB" after negative
  1352.   numbers.  However, probably the most common PICTURE templates that you
  1353.   will use are upper-case ("@!") or phone numbers ("@R (###) ###-####").
  1354.   
  1355.   Default Colors: This enables you to change the default colors for the
  1356.   current column.  (NOTE: This requires at least power user security.) The
  1357.   "Standard" color is used for all of the data in the column.  The
  1358.   "Enhanced" color is used only for the highlight bar in that column. Use
  1359.   the up and down arrows to change the color, or the left/right arrows to
  1360.   change the current column (Standard/Enhanced).  Any changes you make
  1361.   here will be reflected as soon as you exit back to the submenu.
  1362.   
  1363.   Override Colors: This powerful option enables you to specify specific
  1364.   color settings based on data conditions.  (NOTE: This requires
  1365.   administrator or developer security, not to mention a good working
  1366.   knowledge of code blocks.) Although it is light years beyond the scope
  1367.   of this manual to explain code blocks or TBrowse (which serves as the
  1368.   underlying data browser mechanism), the following brief description will
  1369.   nonetheless attempt to describe the use of override colors. If your head
  1370.   begins to swim in the next few paragraphs, please feel free to skip
  1371.   ahead to "Browse Attributes"!
  1372.   
  1373.   By default, color #1 (see the "Colors" discussion under "Browse
  1374.   Attributes Menu") will be used to display all data in the column.  Color
  1375.   #2 will be used to display the current cursor position in the column.
  1376.   As previously mentioned, you can change these colors by using the
  1377.   "Default Colors" option described above.  However, "Override Colors"
  1378.   lets you override the default colors based on specific data conditions
  1379.   in the column.
  1380.   
  1381.   There are two simple rules to follow when constructing the code block:
  1382.   
  1383.   - it must accept an argument, because the data item has to be passed to
  1384.   it at evaluation.
  1385.   
  1386.   - it must return an array of two numbers. These two numbers will serve
  1387.   as pointers into the master color table (see "Colors" under "Browse
  1388.   Attributes Menu"), representing the unselected and selected color pair
  1389.   to use for displaying that data.
  1390.  
  1391.  
  1392.                                     -24-                                  
  1393.  
  1394.  
  1395.   Grumpfish Report Generator                                 LOGPlus! v3.0
  1396.  
  1397.  
  1398.   
  1399.   Here is an example of an override color setting:
  1400.   
  1401.   { | x | if("REVIEW" $ x, { 3, 4 }, { 1, 2 } ) }
  1402.   
  1403.   If the word "REVIEW" appears as part of the data in the current cell,
  1404.   colors #3 and #4 will be used to display the data.  Otherwise, colors
  1405.   #1 and #2 will be used.
  1406.   
  1407.   Formulas: This option allows you to add and/or edit numeric formulae
  1408.   for columns that contain numeric data. It will be active only if the
  1409.   currently highlighted column contains numeric data. If you want to
  1410.   change numeric formulae information, you should move to the desired
  1411.   column first, and then go into the Browse Configuration Menu.
  1412.   
  1413.   Exit: This will return you to the Browse Configuration Menu. You may
  1414.   also achieve this by pressing ESC.
  1415.   
  1416.   Browse Attributes
  1417.   
  1418.   This opens a submenu containing additional options specific to the
  1419.   overall browse: "Column Separator", "Header Separator", "Colors", "Lock
  1420.   Columns", "Save Defaults", and "Exit".
  1421.   
  1422.   Column Separator: This allows you to change the default for all of the
  1423.   column separators.  (NOTE: This requires at least power user security.)
  1424.   You will be asked to enter the desired column separator, using the tilde
  1425.   ("~") to mark the end. If you need help with the line drawing
  1426.   characters, press F10 for the handy-dandy line drawing chart. These line
  1427.   drawing characters are all denoted with three-digit codes. Type in the
  1428.   code that applies to the character you want, and it will automatically
  1429.   be inserted for you. (See also "Column Separator" under the "Column
  1430.   Attributes Menu" discussion.)
  1431.   
  1432.   Header Separator: This allows you to change the default for all
  1433.   separators appearing between the column headers and the data.
  1434.   (NOTE: This requires at least power user security.) You will be asked to
  1435.   enter the desired header separator, using the tilde ("~") to mark the
  1436.   end.  As with column separators, you can press F10 for the line drawing
  1437.   character chart. (See also "Header Separator" under the "Column
  1438.   Attributes Menu" discussion.)
  1439.   
  1440.   Colors: This allows you to change the master color palette available for
  1441.   the browse. (NOTE: This requires administrator or developer security.)
  1442.   You will be presented with a list of the current ten color settings.
  1443.   These colors are used by the "Default Colors" and "Override Colors"
  1444.   options on the Column Attributes Menu to control the browse display.
  1445.   Use the up and down arrows to move through the list, and press Enter to
  1446.   change any of the settings.  This will bring up an interactive color
  1447.   palette. Simply use the arrow keys to navigate through the palette to
  1448.  
  1449.  
  1450.                                     -25-                                  
  1451.  
  1452.  
  1453.   Grumpfish Report Generator                                 LOGPlus! v3.0
  1454.  
  1455.  
  1456.   select the desired color.
  1457.   
  1458.   Lock Columns: This enables you to lock columns from the left side of the
  1459.   browse window. Locked columns remain on screen even as you pan
  1460.   horizontally to the right. Simply type in the number of columns you wish
  1461.   to lock. If you want to unlock all columns, enter zero.
  1462.   
  1463.   Save Defaults: This allows you to save your browse color settings (as
  1464.   just discussed) and global column and heading separators for future use.
  1465.   If you choose to save these, they will be saved to the file VIEWDATA.CFG.
  1466.   If this file is detected when you view data on-screen, the settings will
  1467.   automatically be loaded.
  1468.   
  1469.   Exit: This will return you to the Browse Configuration Menu. You may
  1470.   also achieve this by pressing ESC.
  1471.   
  1472.   Move Column
  1473.   
  1474.   This option enables you to move the current column to a different
  1475.   location. You will be given a list of columns and asked to select the
  1476.   target location. If you decide not to move the column, press ESC rather
  1477.   than selecting a target location.
  1478.   
  1479.   Insert Column
  1480.   
  1481.   This option enables you to insert a new column either just before or
  1482.   after the current column. (If you do not want to insert a column, press
  1483.   ESC.)
  1484.   
  1485.   Once the new column has been created, you will be given a list of
  1486.   available fields to serve as the basis for this column (as discussed
  1487.   under the Column Attributes Menu). Use the arrow keys to highlight a
  1488.   field and press Enter to select it. You may also select "Formula", in
  1489.   which case you can type in an user-defined formula using standard
  1490.   Clipper functions.
  1491.   
  1492.   If you insert a column that contains numeric data, you will be given
  1493.   the option to attach numeric formulae to them. The same keys apply
  1494.   as when you are selecting a field via the Display Fields menu option.
  1495.   You may also add or edit numeric formulae information via the
  1496.   Formulas option on the Column Attributes Menu.
  1497.   
  1498.   Delete Column
  1499.   
  1500.   This option will delete the current column. You will be asked for
  1501.   confirmation, which is a good thing because there is absolutely no way
  1502.   to recover a deleted column short of recreating it.
  1503.   
  1504.   Photocopy Column
  1505.   
  1506.  
  1507.  
  1508.                                     -26-                                  
  1509.  
  1510.  
  1511.   Grumpfish Report Generator                                 LOGPlus! v3.0
  1512.  
  1513.  
  1514.   This option is similar to "Move Column", with the difference that this
  1515.   will create a second copy of the current column at the target location.
  1516.   The previous contents of the column at the target location will be lost.
  1517.   
  1518.   Filter Data
  1519.   
  1520.   This powerful option allows you to further restrict the current data subset.
  1521.   It is available only if there is an active sort order. Additionally, the
  1522.   current security level must be power user or greater.  If either of
  1523.   these two conditions is not met, the menu option will not be selectable.
  1524.   
  1525.   If you select this option, you will get a window prompting you to enter
  1526.   a starting and ending value for the subset.  If you type in a starting
  1527.   value, the ending value will assume the same value (for your
  1528.   convenience).  After you have entered the starting and ending value and
  1529.   return to the Browse Configuration Menu, exit to the browse window to
  1530.   see your changes reflected.
  1531.   
  1532.   To remove the starting and/or ending value, leave them blank.
  1533.   
  1534.   TIP: Any data filtering that you do here will be reflected when you
  1535.   output your data to printer, text file, database, spreadsheet, etcetera.
  1536.   This means that you can run a query and then use the Filter Data option
  1537.   to perform a "sub-query".
  1538.   
  1539.   Save Configuration
  1540.   
  1541.   This option enables you to save your customized browse configuration for
  1542.   later re-use.  This will remember any data filter you have set, the
  1543.   current color settings, and the order/contents of the columns.
  1544.   
  1545.   You will be asked to enter a filename up to eight characters.  If you
  1546.   decide not to save your configuration, just leave the filename blank.
  1547.   The file extension .GRV will automatically be added to your filename.
  1548.   
  1549.   TIP: When you use the browse configuration menu to make any changes to
  1550.   the look of your data, you can save that customized view as part of the
  1551.   report. Just save the browse configuration first using the Save
  1552.   Configuration option. Then save your report. When you reload your
  1553.   report, the view file that was active when you saved it will be reloaded
  1554.   automatically. This is extremely useful if you want to change column
  1555.   headers, etcetera.
  1556.   
  1557.   
  1558.   Load Configuration
  1559.   
  1560.   This option enables you to reload a previously saved customized browse
  1561.   configuration.  You will be given a list of all .GRV files in the current
  1562.   directory (or an error message indicating that there are none to be
  1563.   found).  Use the arrow keys to highlight the desired one, and press
  1564.  
  1565.  
  1566.                                     -27-                                  
  1567.  
  1568.  
  1569.   Grumpfish Report Generator                                 LOGPlus! v3.0
  1570.  
  1571.  
  1572.   Enter to load it.
  1573.   
  1574.   NOTE: If you do not have the same database open that was open when the
  1575.   configuration was saved, you will be warned to that effect.
  1576.   
  1577.   Repeat last action
  1578.   
  1579.   This option allows you to repeat any of the following customization
  1580.   actions for column attributes:
  1581.   
  1582.   - column contents
  1583.   - header
  1584.   - column separators
  1585.   - header separators
  1586.   - override colors
  1587.   - PICTURE clause
  1588.   
  1589.   This can save you a lot of time if you want to make the same change(s)
  1590.   to several columns.
  1591.   
  1592.   Undo last action
  1593.   
  1594.   This option allows you to undo the last column customization action.  The
  1595.   same actions that can be repeated can be undone.
  1596.   
  1597.   Exit
  1598.   
  1599.   This simply returns you to the browse window.  You can achieve the same
  1600.   thing by pressing ESC.
  1601.   
  1602.   b) Printer
  1603.   
  1604.   The "Printer" option allows you to send the results of your query/report
  1605.   to the printer, a text file, or the screen.
  1606.   
  1607.   NOTE: This option will only be available when there is at least one
  1608.   field selected for display.
  1609.   
  1610.   When you select this option, you will first be asked if you want to
  1611.   review your print options, which include the header and footer.  If you
  1612.   want to change any of these, answer "Yes".  You will then be changing
  1613.   print options specific to this report.  If you later save the report
  1614.   with the "Save Report" option, these edited print options will be saved
  1615.   along with it.
  1616.   
  1617.   (Print Options will be covered in greater detail under "Printer Setup"
  1618.   in the Globals Menu discussion.)
  1619.   
  1620.   The next question is whether you wish to send output to the printer, a
  1621.   text file, or the screen.  If you select "Printer", you will be asked to
  1622.  
  1623.  
  1624.                                     -28-                                  
  1625.  
  1626.  
  1627.   Grumpfish Report Generator                                 LOGPlus! v3.0
  1628.  
  1629.  
  1630.   verify that the printer is on-line and ready.  Make sure it is, then
  1631.   highlight "Ready" and press Enter.  A status bar will appear showing the
  1632.   progress of your printed report.  (If you have redirected printer output
  1633.   to a text file, the name of the text file will appear above the status
  1634.   bar.) You can cancel the output process at any time by pressing ESC.
  1635.   
  1636.   If you elect to print to a text file, you will be asked if you wish to
  1637.   "suppress control codes".  Control codes are printer codes, such as
  1638.   those which turn on bold or compressed print.  The general rule of thumb
  1639.   is: If you do not ultimately plan on sending this text file to your
  1640.   printer, you should suppress control codes.
  1641.   
  1642.   If you print to the screen, the progress bar will appear as a temporary
  1643.   file is created to hold your report. When the report is complete, it
  1644.   will be displayed on the screen. You can use the arrow keys to scroll
  1645.   through the report. If you want to search for any piece of text, press
  1646.   ALT-S and enter the desired text. If you decide to print the report,
  1647.   print ALT-P.
  1648.   
  1649.   Numeric Formulae: If you have specified one or more formulae for numeric
  1650.   fields, they will be printed one per row at the end of the report (with
  1651.   the exception of subtotals, which of course will be printed following
  1652.   each subgroup).  The order in which the formulae are printed is: Total,
  1653.   Average, Maximum, Minimum, Deviation, and Variance.
  1654.   
  1655.   NOTE: Due to internal limitations, deviation and variance can only be
  1656.   based upon the first 4,096 records. If your report has more records than
  1657.   this, a disclaimer will be printed at the end of the report warning that
  1658.   the deviation and variance figures may be inaccurate.
  1659.   
  1660.   c) Form
  1661.   
  1662.   The "Form" option allows you to create and print your own forms.
  1663.   
  1664.   When you first select this option, you will be presented with a blank
  1665.   screen. The general idea is to insert fields, text, and boxes to create
  1666.   a form that tickles your fancy.  When you are satisfied with your form,
  1667.   you can print it.
  1668.   
  1669.   TIP: If you have EGA or VGA display, you can set Grumpfish Reporter to
  1670.   use expanded video mode for your forms.  This will enable you to put
  1671.   more information on each form.  See "43/50 Line Forms" under the
  1672.   "Globals" menu discussion for more information.
  1673.   
  1674.   The active keys in the form painter are:
  1675.   
  1676.   Key            Action
  1677.   Alt-A          toggle autotrim for current item (character only)
  1678.   Alt-L          load previously saved form
  1679.   Alt-S          save current form
  1680.  
  1681.  
  1682.                                     -29-                                  
  1683.  
  1684.  
  1685.   Grumpfish Report Generator                                 LOGPlus! v3.0
  1686.  
  1687.  
  1688.   Alt-P          print current form
  1689.   Alt-D          delete a form from disk
  1690.   Alt-O          review/change print options
  1691.   Alt-F          insert field at current position
  1692.   Alt-B          insert box at current position
  1693.   Alt-E          erase item at current position
  1694.   Alt-M          move current item
  1695.   Alt-N          delete all items and start over
  1696.   F2             show more info about current item
  1697.   ┘             edit current item (text only)
  1698.   <              slide items on this row one space left
  1699.   >              slide items on this row one space right
  1700.   Ins            insert row at current position
  1701.   Del            delete row at current position
  1702.   Arrow keys     move cursor
  1703.   Home           move to top left corner
  1704.   Tab            move right five columns
  1705.   Shift-Tab      move left five columns
  1706.   PgUp           move to top row
  1707.   PgDn           move to bottom row
  1708.   Ctrl-Left      move to start of item (or leftmost column)
  1709.   Ctrl-Right     move to end of item (or rightmost column)
  1710.   
  1711.   Moving the Cursor
  1712.   
  1713.   You can move the cursor on the form with the arrow keys, PgUp, PgDn,
  1714.   Home, End, Tab, Shift-Tab, Ctrl-Left and Ctrl-Right.  Note that if the
  1715.   cursor is positioned on a field, box, or text, field, the Ctrl-Left and
  1716.   Ctrl-Right keys will move you to the left and right edge of that item.
  1717.   
  1718.   Inserting Items
  1719.   
  1720.   To insert fields, move the cursor to the desired location and press
  1721.   Alt-F. You will be given a list of all available fields.  Highlight the
  1722.   one you want, and press Enter to insert it.
  1723.   
  1724.   To insert text, move the cursor to desired location and just start
  1725.   typing.  You can exit the editing process by pressing Enter, Up arrow,
  1726.   or Down arrow. TIP: Using the arrows to exit editing enables you to type
  1727.   several pieces of text on different rows very quickly.
  1728.   
  1729.   To insert a box, move the cursor to the desired location for the top
  1730.   left corner and press Alt-B.  You will be given a list of available box
  1731.   outlines.  Highlight the one you want and press Enter to select it.
  1732.   Use the arrow keys to size the box to your liking, and press Enter again
  1733.   when you are finished to anchor it.
  1734.   
  1735.   Editing Text
  1736.   
  1737.   Move the cursor to anywhere on the text in question and press Enter.
  1738.  
  1739.  
  1740.                                     -30-                                  
  1741.  
  1742.  
  1743.   Grumpfish Report Generator                                 LOGPlus! v3.0
  1744.  
  1745.  
  1746.   Type the new text and press Enter when you are finished.
  1747.   
  1748.   Moving Items
  1749.   
  1750.   To move any item, press Alt-M while the cursor is positioned on it.  The
  1751.   color of the item will change to indicate that it is active.  The following
  1752.   keys are active when moving items:
  1753.   
  1754.   Key            Action
  1755.   Up             Move item up one row
  1756.   Down           Move item down one row
  1757.   Left           Move item left one column
  1758.   Right          Move item right one column
  1759.   PgUp           Move item to top row
  1760.   PgDn           Move item to bottom row
  1761.   L              Left-justify item
  1762.   C              Center item
  1763.   R              Right-justify item
  1764.   Ctrl-Left      Left-justify item
  1765.   Ctrl-Right     Right-justify item
  1766.   Esc            Cancel movement
  1767.   
  1768.   Press Enter when you are finished moving the item.  Note that items
  1769.   cannot be stacked on top of each other.
  1770.   
  1771.   Autotrim
  1772.   
  1773.   Autotrim is useful for merge mailings. It will remove any trailing
  1774.   spaces from character data, so that you can combine several data fields
  1775.   together without having large gaps between them. To toggle autotrim
  1776.   status on any character field, place the cursor on it and press Alt-A.
  1777.   
  1778.   Deleting Individual Items
  1779.   
  1780.   To delete an item, move the cursor on top of it and press Alt-E. You
  1781.   will be asked for confirmation.
  1782.   
  1783.   Deleting All Items
  1784.   
  1785.   To delete all items and start again with a fresh slate, press Alt-N. You
  1786.   will be asked for confirmation.  Be certain that you want to do this --
  1787.   there is no way to recover deleted items!
  1788.   
  1789.   Moving All Items on Row
  1790.   
  1791.   To move all items on a row left or right, move the cursor to that row
  1792.   and press "<" or ">", respectively.  Note that these keys will not
  1793.   work for items that are inside a box.
  1794.   
  1795.   Print Options
  1796.  
  1797.  
  1798.                                     -31-                                  
  1799.  
  1800.  
  1801.   Grumpfish Report Generator                                 LOGPlus! v3.0
  1802.  
  1803.  
  1804.   
  1805.   Press Alt-O to review and/or change print options.
  1806.   
  1807.   Page Break Between Forms: This determines whether or not to print only
  1808.   one form per page.  If you answer "No", then as many forms will be
  1809.   printed as will fit on one page.
  1810.   
  1811.   # of lines per page: This determines the page length.
  1812.   
  1813.   # of lines between forms: This serves as a separator between forms.
  1814.   Also note that if you begin the form on a row other than the top row,
  1815.   those blank lines will serve as an additional separator between forms.
  1816.   
  1817.   Pause between forms: Answer "Yes" to this if you need to manually change
  1818.   paper between forms.
  1819.   
  1820.   # of copies to print: This is self-explanatory.  Note that forms will be
  1821.   printed for collating -- in other words, if you are printing two copies
  1822.   of forms for four records, they will be printed 1-2-3-4, 1-2-3-4.
  1823.   
  1824.   The top and left margin options are self-explanatory. By default, both
  1825.   are set at zero.
  1826.   
  1827.   Printing a Form
  1828.   
  1829.   Press Alt-P to print a form. You will be asked if you wish to review your
  1830.   print options. You will then be asked if you want to send the output to
  1831.   the printer, a text file, or the screen. If you select Printer, you will
  1832.   be asked to verify that the printer is on-line and ready.
  1833.   
  1834.   A status bar will appear showing the progress of your printed report.
  1835.   (If you have redirected printer output to a text file, the name of the
  1836.   text file will appear above the status bar.) You can cancel the output
  1837.   process at any time by pressing ESC.
  1838.   
  1839.   If you elect to print to a text file, you will be asked if you wish to
  1840.   "suppress control codes".  Control codes are printer codes, such as
  1841.   those which turn on bold or compressed print.  The general rule of thumb
  1842.   is: If you do not ultimately plan on sending this text file to your
  1843.   printer, you should suppress control codes.
  1844.   
  1845.   Saving Forms
  1846.   
  1847.   You can save forms for later use by pressing Alt-S. This will save all
  1848.   items that you have placed on your form, current query condition (if
  1849.   any), and form print options, along with a description of the form which
  1850.   you provide.
  1851.   
  1852.   You will be first asked to enter a description.  Your description may be
  1853.   up to 60 characters long. If you decide not to save the form, just leave
  1854.  
  1855.  
  1856.                                     -32-                                  
  1857.  
  1858.  
  1859.   Grumpfish Report Generator                                 LOGPlus! v3.0
  1860.  
  1861.  
  1862.   the description empty. Press Enter when you are finished typing the
  1863.   description.
  1864.   
  1865.   You will then be asked to enter a filename, which may be up to 8
  1866.   characters long.  (You can back out of this by leaving the filename
  1867.   empty).  The ".GRF" file extension will be added automatically. If you
  1868.   enter the name of an existing file, you will be warned that you are
  1869.   about to overwrite it.
  1870.   
  1871.   The message "Saving Form" should appear briefly, then disappear.
  1872.   
  1873.   Loading Forms
  1874.   
  1875.   To re-load a previously saved form, press Alt-L.  You will be presented
  1876.   with a list of descriptions of previously saved forms along with the
  1877.   date/time that they were created (or an error message if there are no
  1878.   forms found).  Use the arrow key to highlight the one you want, and
  1879.   press Enter.
  1880.   
  1881.   If there is a data dictionary saved with this form, and there is no
  1882.   data dictionary open at the time that you load it, the applicable data
  1883.   dictionary will be loaded immediately.
  1884.   
  1885.   If there is no data dictionary saved with this form, and the open files
  1886.   do not match the fields required for the form, you will get an error
  1887.   message to that effect and the form will not be loaded.
  1888.   
  1889.   Deleting Forms
  1890.   
  1891.   You can delete previously saved form files by pressing Alt-D. You will
  1892.   be presented with a list of descriptions of previously saved forms (or
  1893.   an error message if there are no forms found). Use the arrow key to
  1894.   highlight the form you wish to delete, and press Enter.
  1895.   
  1896.   NOTE: Whenever you save a form, the current security level will be saved
  1897.   along with it. You will only be able to delete that form if you have at
  1898.   least the same security level as the person who created it.
  1899.   
  1900.   Showing More Information About an Item
  1901.   
  1902.   If you would like to see more information about any item in the form
  1903.   painter, place the cursor on it and press F2.  This is most useful for
  1904.   fields, because the database name will not be shown on the form painter
  1905.   due to space restrictions.
  1906.   
  1907.   d) Label
  1908.   
  1909.   The "Label" option allows you to create and print labels. Its operation
  1910.   is very similar to the form painter.
  1911.   
  1912.  
  1913.  
  1914.                                     -33-                                  
  1915.  
  1916.  
  1917.   Grumpfish Report Generator                                 LOGPlus! v3.0
  1918.  
  1919.  
  1920.   When you first go into the label painter, you will see a box in the
  1921.   upper left corner.  This box represents your label.  Any text or fields
  1922.   that you put in your label must fit within the box, and you will not be
  1923.   allowed to move the screen or mouse cursors outside its boundaries.
  1924.   
  1925.   The active keys in the label painter are:
  1926.   
  1927.   Key            Action
  1928.   Alt-A          toggle autotrim for current item (character only)
  1929.   Alt-L          load previously saved label file
  1930.   Alt-S          save current label
  1931.   Alt-P          print current label
  1932.   Alt-D          delete a label file from disk
  1933.   Alt-O          review/change print options
  1934.   Alt-F          insert field at current position
  1935.   Alt-B          insert box at current position
  1936.   Alt-E          erase item at current position
  1937.   Alt-M          move current item
  1938.   Alt-N          delete all items and start over
  1939.   F2             show more info about current item
  1940.   ┘             edit current item (text only)
  1941.   <              slide items on this row one space left
  1942.   >              slide items on this row one space right
  1943.   Ins            insert row at current position
  1944.   Del            delete row at current position
  1945.   Arrow keys     move cursor
  1946.   Home           move to top left corner
  1947.   Tab            move right five columns
  1948.   Shift-Tab      move left five columns
  1949.   PgUp           move to top row
  1950.   PgDn           move to bottom row
  1951.   Ctrl-Left      move to start of item (or leftmost column)
  1952.   Ctrl-Right     move to end of item (or rightmost column)
  1953.   
  1954.   Label Boundary
  1955.   
  1956.   To change the label boundary box, press ALT-O for Label Print Options.
  1957.   The label width and height directly affect the size of this box. While
  1958.   editing Label Print Options, you may press ALT-L to load a standard
  1959.   label size.  This will give you a window similar to Figure 38 containing
  1960.   over 70 different standard label formats.  Highlight your label type and
  1961.   press Enter.
  1962.   
  1963.   If you are using a label that is not supported by Grumpfish Reporter,
  1964.   please contact us so that we can add support for it.
  1965.   
  1966.   Label Print Options
  1967.   
  1968.   Are labels continuous: If you answer "No", then Grumpfish Reporter
  1969.   will eject each page from the printer.  (Default is yes.)
  1970.  
  1971.  
  1972.                                     -34-                                  
  1973.  
  1974.  
  1975.   Grumpfish Report Generator                                 LOGPlus! v3.0
  1976.  
  1977.  
  1978.   
  1979.   # of labels across: This is the number of labels across the page, and
  1980.   can be between one and four.  (The default is three.)
  1981.   
  1982.   # of lines down: This is the number of labels down the page, and can
  1983.   be between one and twelve. (The default is ten.)
  1984.   
  1985.   Lines per inch: This can be either 6 or 8.  8 lines per inch allows you
  1986.   to cram more information onto each label.  Note that you will only be
  1987.   able to change to 8 lines per inch if the currently active printer
  1988.   supports that.
  1989.   
  1990.   Compressed: This enables compressed print, which also allows you to cram
  1991.   more information onto a label. You will only be able to select
  1992.   compressed print if the currently active printer supports it.
  1993.   
  1994.   Label width: This is the label width in inches.  This may be between
  1995.   zero and 8.5.  (The default is 2.5 inches.)
  1996.   
  1997.   Label height: This is the label height in inches.  This may be between
  1998.   zero and 11.  (The default is 1 inch.)
  1999.   
  2000.   Gap between labels rows: This is the amount of space to put between each
  2001.   row of labels.  It may be between zero and three. (The default is one
  2002.   quarter inch.)
  2003.   
  2004.   Top and left margin options are self-explanatory. By default, both are
  2005.   set at zero.
  2006.   
  2007.   Pause between labels: If you answer "Yes", Grumpfish Reporter will pause
  2008.   between each label.  By default, there is no pause.
  2009.   
  2010.   # of copies to print: This is self-explanatory.
  2011.   
  2012.   Moving the Cursor
  2013.   
  2014.   You can move the cursor on the form with the arrow keys, PgUp, PgDn,
  2015.   Home, End, Tab, Shift-Tab, Ctrl-Left and Ctrl-Right.  If the cursor is
  2016.   positioned on a field, box, or text, field, the Ctrl-Left and Ctrl-Right
  2017.   keys will move you to the left and right edge of that item.
  2018.   
  2019.   Inserting Items
  2020.   
  2021.   To insert fields, move the cursor to the desired location and press
  2022.   Alt-F. You will be given a list of all available fields.  Highlight the
  2023.   one you want, and press Enter to insert it.
  2024.   
  2025.   To insert text, move the cursor to desired location and just start
  2026.   typing.  You can exit the editing process by pressing Enter, Up arrow,
  2027.   or Down arrow.
  2028.  
  2029.  
  2030.                                     -35-                                  
  2031.  
  2032.  
  2033.   Grumpfish Report Generator                                 LOGPlus! v3.0
  2034.  
  2035.  
  2036.   
  2037.   To insert a box, move the cursor to the desired location for the top
  2038.   left corner and press Alt-B.  You will be given a list of available box
  2039.   outlines.  Highlight the one you want and press Enter to select it.
  2040.   Use the arrow keys to size the box to your liking, and press Enter again
  2041.   when you are finished to anchor it.  Note that boxes must fit within the
  2042.   confines of the label boundary box.
  2043.   
  2044.   Editing Text
  2045.   
  2046.   Move the cursor to anywhere on the text in question and press Enter.
  2047.   Type the new text and press Enter when you are finished.  Remember that
  2048.   your text must fit within the constraints of the label boundary box.
  2049.   
  2050.   Moving Items
  2051.   
  2052.   To move any item, press Alt-M while the cursor is positioned on it.  The
  2053.   color of the item will change to indicate that it is active.  The following
  2054.   keys are active when moving items:
  2055.   
  2056.   Key            Action
  2057.   Up             Move item up one row
  2058.   Down           Move item down one row
  2059.   Left           Move item left one column
  2060.   Right          Move item right one column
  2061.   PgUp           Move item to top row
  2062.   PgDn           Move item to bottom row
  2063.   L              Left-justify item
  2064.   C              Center item
  2065.   R              Right-justify item
  2066.   Ctrl-Left      Left-justify item
  2067.   Ctrl-Right     Right-justify item
  2068.   Esc            Cancel movement
  2069.   
  2070.   Press Enter when you are finished moving the item.  Note that items
  2071.   cannot be stacked on top of each other.
  2072.   
  2073.   Autotrim
  2074.   
  2075.   Autotrim removes any trailing spaces from character data, so that you
  2076.   can combine several data fields together without having large gaps
  2077.   between them. To toggle autotrim status on any character field, place
  2078.   the cursor on it and press Alt-A.
  2079.   
  2080.   Deleting Individual Items
  2081.   
  2082.   To delete an item, move the cursor on top of it and press Alt-E. You
  2083.   will be asked for confirmation.
  2084.   
  2085.   Deleting All Items
  2086.  
  2087.  
  2088.                                     -36-                                  
  2089.  
  2090.  
  2091.   Grumpfish Report Generator                                 LOGPlus! v3.0
  2092.  
  2093.  
  2094.   
  2095.   To delete all items and start again with a fresh slate, press Alt-N. You
  2096.   will be asked for confirmation.
  2097.   
  2098.   Moving All Items on Row
  2099.   
  2100.   To move all items on a row left or right, move the cursor to that row
  2101.   and press "<" or ">", respectively.  Note that these keys will not
  2102.   work for items that are inside a box.
  2103.   
  2104.   Printing a Label
  2105.   
  2106.   Press Alt-P to print a label. You will be asked if you wish to review
  2107.   your print options. You will then be asked if you want to send the
  2108.   output to the printer, a file, or the screen.
  2109.   
  2110.   If you select Printer, you will be asked to verify that the printer is
  2111.   on-line and ready. You will also be given the chance to print one or
  2112.   more test labels to verify proper alignment.
  2113.   
  2114.   A status bar will appear showing the progress of the label print
  2115.   process. (If you have redirected printer output to a text file, the name
  2116.   of the text file will appear above the status bar.) You can cancel the
  2117.   output process at any time by pressing ESC.
  2118.   
  2119.   If you elect to print to a text file, you will be asked if you wish to
  2120.   "suppress control codes".  Control codes are printer codes, such as
  2121.   those which turn on bold or compressed print.  The rule of thumb
  2122.   is: If you do not ultimately plan on sending this text file to your
  2123.   printer, you should suppress control codes.
  2124.   
  2125.   Saving Labels
  2126.   
  2127.   You can save labels for later use by pressing Alt-S. This will save all
  2128.   items in the label boundary box, the label print options, and a
  2129.   description of the form which you provide.
  2130.   
  2131.   You will be first asked to enter a description.  Your description may be
  2132.   up to 60 characters long. If you decide not to save the form, just leave
  2133.   the description empty. Press Enter when you are finished typing the
  2134.   description.
  2135.   
  2136.   You will then be asked to enter a filename, which may be up to 8
  2137.   characters long.  (You can back out of this by leaving the filename
  2138.   empty).  The ".GRL" file extension will be added automatically. If you
  2139.   enter the name of an existing file, you will be warned that you are
  2140.   about to overwrite it.
  2141.   
  2142.   The message "Saving Label" should appear briefly, then disappear.
  2143.   
  2144.  
  2145.  
  2146.                                     -37-                                  
  2147.  
  2148.  
  2149.   Grumpfish Report Generator                                 LOGPlus! v3.0
  2150.  
  2151.  
  2152.   Loading Labels
  2153.   
  2154.   To re-load a previously saved label, press Alt-L.  You will be presented
  2155.   with a list of descriptions of previously saved labels along with the
  2156.   date/time that they were created (or an error message if there are no
  2157.   labels found).  Use the arrow key to highlight the one you want, and
  2158.   press Enter.
  2159.   
  2160.   If there is no data dictionary saved with this label, and the open files
  2161.   do not match the fields required for the label, you will get an error
  2162.   message to that effect and the label will not be loaded.
  2163.   
  2164.   Deleting Labels
  2165.   
  2166.   You can delete previously saved label files by pressing Alt-D. You will
  2167.   be presented with a list of descriptions of previously saved labels (or
  2168.   an error message if there are no labels found). Use the arrow key to
  2169.   highlight the label you wish to delete, and press Enter.
  2170.   
  2171.   NOTE: Whenever you save a label, the current security level will be saved
  2172.   along with it. You will only be able to delete that label if you have at
  2173.   least the same security level as the person who created it.
  2174.   
  2175.   Showing More Information About an Item
  2176.   
  2177.   If you would like to see more information about any item in the label
  2178.   painter, place the cursor on it and press F2.
  2179.   
  2180.   e) CrossTab
  2181.   
  2182.   This option allows you to create a crosstab report. A crosstab is a
  2183.   special kind of report which creates a numeric matrix. Crosstabs are
  2184.   excellent for providing spreadsheet-like summary representations of your
  2185.   data.
  2186.   
  2187.   For example, let's suppose that you have a database which has
  2188.   departmental sales figures. It includes fields such as DEPARTMENT,
  2189.   SALESPERSON, SALESDATE, ITEM, QUANTITY, PRICE, etc. A crosstab report
  2190.   allows you to see how much each salesperson sold for each department.
  2191.   The matrix will look something like this:
  2192.   
  2193.                      Department
  2194.   Sales People       Clothing     Housewares    Automotive
  2195.   -----------------------------------------------------------
  2196.   Maynard Algar        13,223          9,432        14,221
  2197.   Don Bayne            32,332         12,345         5,443
  2198.   Dweebus McDuck          109            365        11,287
  2199.   
  2200.   To set up a crosstab report, you must pick a field for the rows going
  2201.   down the left side and a field for columns across the top. For each
  2202.  
  2203.  
  2204.                                     -38-                                  
  2205.  
  2206.  
  2207.   Grumpfish Report Generator                                 LOGPlus! v3.0
  2208.  
  2209.  
  2210.   unique value of those two fields, the report will either sum a third
  2211.   field or count records. (This is the number which goes in the middle of
  2212.   the matrix.)
  2213.   
  2214.   You can specify headers for the rows and columns. You can tell whether
  2215.   or not to sort the row and column values. You can also get row and/or
  2216.   column totals.
  2217.   
  2218.   Row and column values can be of any type, although most often they will
  2219.   probably be either character or dates. If the row or column field is a
  2220.   date field, the user can pick from several options for grouping the
  2221.   dates. This is useful, for example, if you want to show the sales for
  2222.   each month or each year.
  2223.   
  2224.   Because of the dynamic nature of a crosstab report, be careful what you
  2225.   ask it to do. If the field you pick for the columns contains 20,000
  2226.   unique values, you will never be able to print a meaningful report. Be
  2227.   realistic!
  2228.   
  2229.   Grumpfish Reporter automatically determines the width of your report and
  2230.   will split the report across multiple pages if not all columns will fit
  2231.   on a single page.
  2232.   
  2233.   When you select the Crosstab option, you will be presented with a small
  2234.   menu of other options which include: "Create/Edit Crosstab", "Load
  2235.   Crosstab", "Save Crosstab", "Print Crosstab", and "Clear Crosstab".
  2236.   These should all be self-explanatory.
  2237.   
  2238.   Select "Create/Edit Crosstab". Let's run through the options in the
  2239.   order that you will be asked to input them:
  2240.   
  2241.   Row Field: You must enter this to run a crosstab report. Either type in
  2242.   the name of the desired field or press Enter to display the list of
  2243.   available fields and select from that.
  2244.                                                                                   
  2245.   If you select a date field, you will be given an additional menu of
  2246.   subgrouping options:
  2247.   
  2248.   Date        - group by date (default)
  2249.   Day of Week - group by day of the week (i.e., Sunday, Monday, etc.)
  2250.   Week        - group by week (each week starts on Sunday)
  2251.   Month       - group by month (i.e, Jan 94, Feb 94, Mar 94)
  2252.   Year        - group by year
  2253.   
  2254.   Row Header: This can be a description for the row field. If used, this
  2255.   will be printed over the row descriptions on the left side of the
  2256.   crosstab report.
  2257.   
  2258.   Row Header Width: Enter the desired width for the row header and the row
  2259.   descriptions. This width can be wider or narrower than the width of the
  2260.  
  2261.  
  2262.                                     -39-                                  
  2263.  
  2264.  
  2265.   Grumpfish Report Generator                                 LOGPlus! v3.0
  2266.  
  2267.  
  2268.   field you chose for rows.
  2269.   
  2270.   Row Sort: This determines whether or not the row descriptions will be
  2271.   sorted on the left side of the report.  Character data will be sorted
  2272.   alphabetically in ascending order.  Numeric data will be sorted in
  2273.   ascending order.
  2274.   
  2275.   Column Field: You must enter this to run a crosstab report. Either type
  2276.   in the name of the desired field or press Enter to display the list of
  2277.   available fields and select from that.
  2278.                                                                                   
  2279.   If you select a date field, you will be given an additional menu of
  2280.   subgrouping options as described above under "Row Field".
  2281.   
  2282.   Column Sort: This controls whether or not to the column descriptions
  2283.   will be sorted across the top of the crosstab report.
  2284.   
  2285.   Column Header: This can be a description for the column field. If used,
  2286.   this will be printed one line above the column descriptions. If you
  2287.   leave it blank, the extra row will not be printed.
  2288.   
  2289.   Count or Sum: Type "C" if you want to the report to count the number
  2290.   of entries which match the row and column fields. Otherwise, enter "S"
  2291.   if you wish to sum a numeric field (see "Field to Sum" below).
  2292.   
  2293.   Use Commas: This determines whether or not to insert commas into
  2294.   numbers printed in the body of the crosstab report. This will affect
  2295.   the width of the columns. If you are summing, you can also affect the
  2296.   column width by changing the number of decimal places to use (see
  2297.   below).
  2298.   
  2299.   Field to Sum: If you wish to sum a numeric field, then you should type
  2300.   in the name of the desired field or press Enter to select from the list
  2301.   of available fields. (This does not apply if you have chosen to Count
  2302.   rather than Sum.)
  2303.   
  2304.   Decimals: This is the number of decimal places to use for the numbers in
  2305.   the body of the crosstab report. This will affect the width of the
  2306.   columns.  TIP: Remember to account for the decimal point; for example,
  2307.   selecting two decimal places will increase the column width by three.
  2308.   
  2309.   Column Totals: This allows you to show totals at the bottom of each
  2310.   column. If you select totals for both rows and columns, grand totals
  2311.   will also be printed.
  2312.   
  2313.   Row Totals: This allows you to show totals at the end of each row, which
  2314.   of course will affect the overall width of the crosstab report. If you
  2315.   select totals for both rows and columns, grand totals will also be printed.
  2316.   
  2317.   Page Length: Self-explanatory. (The default is 66.)
  2318.  
  2319.  
  2320.                                     -40-                                  
  2321.  
  2322.  
  2323.   Grumpfish Report Generator                                 LOGPlus! v3.0
  2324.  
  2325.  
  2326.   
  2327.   Left Margin: Self-explanatory. (The default is 5.)
  2328.   
  2329.   Top Margin: Self-explanatory. (The default is 0.)
  2330.   
  2331.   Column Spacing: This is the number of spaces to separate each of the
  2332.   columns on the crosstab.  The default spacing is 1, and you can
  2333.   increase this as high as 19 if you wish.
  2334.   
  2335.   Double-Spaced Output is self-explanatory. (Default is single-spaced.)
  2336.   
  2337.   Auto-Compress: This determines whether Grumpfish Reporter will force
  2338.   your printer to compressed mode for crosstabs wider than 80 columns
  2339.   (110 columns for landscape, 140 columns for landscape legal).  By
  2340.   default, auto-compress is turned on. However, you might want to turn it
  2341.   off if you have a printer that will accommodate wide paper.  Naturally,
  2342.   this feature will not do anything if your printer doesn't support
  2343.   compressed mode.
  2344.   
  2345.   Printer Port: This determines the port to which to send the report.
  2346.   Grumpfish Reporter supports LPT1-3 and COM1-4.
  2347.   
  2348.   There are four other options that may appear in this window depending
  2349.   upon the type of printer you are using.
  2350.   
  2351.   a) If you are using a laser printer, you will be given the option of
  2352.   changing the page orientation.  "P" is Portrait, which is standard 8
  2353.   1/2" width, 11" length.  "L" is Landscape, which is 11" width, 8 1/2"
  2354.   length.
  2355.   
  2356.   b) If you have a printer that supports legal size paper, you can specify
  2357.   that by answering Yes to the "Legal" question. (By default, letter size
  2358.   will be used.)
  2359.   
  2360.   c) If you have a printer that supports A4 size paper, you can use that
  2361.   by answering Yes to the "A4" question. (By default, letter size will be
  2362.   used.)
  2363.   
  2364.   d) If you have a printer that supports 8 lines per inch, you will be
  2365.   given the option of switching between 6 and 8 LPI.  8 LPI allows you to
  2366.   squash more data onto the printed page (at the potential risk of losing
  2367.   your eyesight when you attempt to read it).
  2368.   
  2369.   The Header section is similar to the header section of the Printer
  2370.   Options screen. The header is composed of four lines, and each of those
  2371.   four lines is divided into three sections: Left, Center, and Right.
  2372.   Items in the Left section will be printed flush against the left margin.
  2373.   Items in the Center section will be centered horizontally on the row.
  2374.   Items in the Right section will be printed flush against the right
  2375.   margin.  You may insert stock items (e.g., date, time) into any of the
  2376.  
  2377.  
  2378.                                     -41-                                  
  2379.  
  2380.  
  2381.   Grumpfish Report Generator                                 LOGPlus! v3.0
  2382.  
  2383.  
  2384.   header locations by pressing F10. You may also insert a free-format
  2385.   function by selecting "<FUNCTION>". It can be any function that is
  2386.   available to the application.
  2387.   
  2388.   The default header for a crosstab report is:
  2389.   
  2390.   Line 1:   Date (flush left), Company Name (centered), Page # (flush right)
  2391.   Line 2:   Time (flush left)
  2392.   
  2393.   Lines Between Header and Column Headings: This represents the number of
  2394.   blank lines to insert between the end of the report header and the
  2395.   beginning of the column headings.  The default value is 1, though you
  2396.   can increase it to as many as 9.
  2397.   
  2398.   f) Database
  2399.   
  2400.   The "Database" option allows you to send the results of your
  2401.   query/report to a new database file.
  2402.   
  2403.   NOTE: This option will only be available when there is at least one
  2404.   field selected for display.
  2405.   
  2406.   When you select this option, you will be asked for a filename (up to
  2407.   eight characters).  The file extension .DBF will be added automatically.
  2408.   The status bar will appear showing the progress of the output.  You may
  2409.   cancel the output process at any time by pressing ESC.
  2410.   
  2411.   g) Quattro/Lotus/Excel
  2412.   
  2413.   The "Quattro/Lotus/Excel" option allows you to send the results of your
  2414.   query/report to a spreadsheet file.
  2415.   
  2416.   NOTE: This option will only be available when there is at least one
  2417.   field selected for display.
  2418.   
  2419.   When you select this option, you will first be asked what type of
  2420.   spreadsheet you wish to create.  Grumpfish Reporter supports Lotus 2,
  2421.   Lotus 3, Quattro, Quattro Pro, Excel 2, Excel 3, and Excel 4.  Highlight
  2422.   the desired type and press Enter.  You will then be asked for a filename
  2423.   (up to eight characters).  The appropriate file extension will be added
  2424.   automatically.
  2425.   
  2426.   You will then be asked if you want cells to be protected.  This will
  2427.   only have an effect when you are using the spreadsheet in Lotus,
  2428.   Quattro, or Excel.
  2429.   
  2430.   The status bar will appear showing the progress of the output.  You may
  2431.   cancel the output process at any time by pressing ESC.
  2432.   
  2433.   Note that numeric fields will be output using Fixed format, along with
  2434.  
  2435.  
  2436.                                     -42-                                  
  2437.  
  2438.  
  2439.   Grumpfish Report Generator                                 LOGPlus! v3.0
  2440.  
  2441.  
  2442.   the number of decimals.  This is to alleviate inconsistency when using
  2443.   deviation and variation, which can often contain a different number of
  2444.   decimals than the data in the rest of the column.
  2445.   
  2446.   Also note that if you have specified formulae for numeric fields, they
  2447.   will be written to the spreadsheet using the appropriate @Formula (i.e.,
  2448.   @SUM, @AVG, @MIN, @MAX, @VAR, @STD).
  2449.   
  2450.   h) ASCII
  2451.   
  2452.   The "ASCII" option allows you to send your data to an ASCII file.
  2453.   This is not the same as redirecting a report to a text file, and is
  2454.   better suited for data transfer between microcomputers and minicomputers
  2455.   or mainframes.
  2456.   
  2457.   The format of the ASCII file may be either SDF (system data format) or
  2458.   DELIMITED. In an SDF file, each record is fixed length and separated by
  2459.   a carriage return/line feed.  Fields are fixed length and there is no
  2460.   field separator.  Character fields are padded with trailing blanks,
  2461.   numeric fields are padded with leading blanks, date fields are written
  2462.   in the form yyyymmdd, and logical fields are written as T or F.  The
  2463.   end-of-file marker is ASCII character 26.
  2464.   
  2465.   In an ASCII DELIMITED file, records are variable length and separated by
  2466.   a carriage return/line feed. Fields are variable length and separated by
  2467.   commas. Character fields are enclosed in double quotes. Leading and
  2468.   trailing spaces for numeric and character fields are truncated, date
  2469.   fields are written in the form yyyymmdd, and logical fields are written
  2470.   as T or F.  The end-of-file mark is ASCII character 26.
  2471.   
  2472.   NOTE: This option will only be available when there is at least one
  2473.   field selected for display.
  2474.   
  2475.   i) Treeducer
  2476.   
  2477.   The "Treeducer" option allows you to print a report using the Treeducer
  2478.   product. Treeducer allows us to save paper when printing with laserjet
  2479.   printers.  It also provides comprehensive support for numerous laser
  2480.   printer options, including: frame style; paper source, line numbering;
  2481.   mini font; duplex; multiple copies; text wrapping; and greenbar shading.
  2482.   
  2483.   NOTE: This option will only be available when there is at least one
  2484.   field selected for display.
  2485.   
  2486.   j) Load Report
  2487.   
  2488.   The "Load Report" option allows you to load a previously saved report.
  2489.   The quick key associated with this menu option is Alt-R.
  2490.   
  2491.   When you select this option, you will be presented with a list of
  2492.  
  2493.  
  2494.                                     -43-                                  
  2495.  
  2496.  
  2497.   Grumpfish Report Generator                                 LOGPlus! v3.0
  2498.  
  2499.  
  2500.   descriptions of previously saved reports along with the date/time that
  2501.   they were created (or an error message if there are no reports found).
  2502.   Use the arrow key to highlight the one you want, and press Enter.
  2503.   
  2504.   Any data dictionary, database files, and/or view files associated with
  2505.   this report will be opened automatically.  If a data dictionary and/or
  2506.   database is open, you will be asked for confirmation before they are
  2507.   loaded.
  2508.   
  2509.   When you load a report, the following global settings will be overridden
  2510.   by whatever was saved with the report: active date format; company name;
  2511.   and show alias.
  2512.   
  2513.   k) Save Report
  2514.   
  2515.   The "Save Report" option allows you to save a report for later use. This
  2516.   will save the following information: name and order of the display
  2517.   fields; current sort order and query condition (if any); print options;
  2518.   active date format; company name; currently selected printer; show alias
  2519.   setting; and a report description which you provide at this time.
  2520.   
  2521.   NOTE: This option will only be available if there is at least one
  2522.   field selected for display.
  2523.   
  2524.   When you select this option, you will be first asked to enter a
  2525.   description.  Your description may be up to 60 characters long. If you
  2526.   decide not to save the report, just leave the description empty. Press
  2527.   Enter when you are finished typing the description.
  2528.   
  2529.   You will then be asked to enter a filename, which may be up to 8
  2530.   characters long.  (Once again, you can back out of this by leaving the
  2531.   filename empty).  The ".GRR" file extension will be added automatically.
  2532.   If you enter the name of an existing file, you will be warned that you
  2533.   are about to overwrite it.
  2534.   
  2535.   The message "Saving Report" should appear briefly, then disappear.
  2536.   
  2537.   You can then re-load this report later by using either the "Load Report"
  2538.   option or the /R command-line parameter.
  2539.   
  2540.   l) Clear Report
  2541.   
  2542.   The "Clear Report" option allows you to clear any selected display
  2543.   fields, sort fields, and query condition, while leaving the databases
  2544.   and active data dictionary (if any) open.
  2545.   
  2546.   m) Delete Report
  2547.   
  2548.   The "Delete Report" option allows you to delete a previously saved
  2549.   report file.
  2550.  
  2551.  
  2552.                                     -44-                                  
  2553.  
  2554.  
  2555.   Grumpfish Report Generator                                 LOGPlus! v3.0
  2556.  
  2557.  
  2558.   
  2559.   When you select this option, you will be presented with a list of
  2560.   descriptions of previously saved reports (or an error message if there
  2561.   are no reports found).  Use the arrow key to highlight the report you
  2562.   want to delete, and press Enter.
  2563.   
  2564.   NOTE: Whenever you save a report, the current security level will be
  2565.   saved along with it.  You will only be able to delete that report if you
  2566.   have at least the same security level as the person who created it.
  2567.   
  2568.   
  2569.   VIII. DATA DICTIONARY MENU
  2570.   
  2571.   The Data Dictionary menu contains the following options: "New", "Edit",
  2572.   "Print", "Load", "Save", "Save and Load", "Clear", and "Delete".  Nearly
  2573.   all of these menu options require administrator/developer level
  2574.   security.  The reason is that the average end user will be tremendously
  2575.   confused by the process of creating a data dictionary.
  2576.   
  2577.   a) New
  2578.   
  2579.   The "New" option allows you to create a new data dictionary.  The quick
  2580.   key associated with this menu option is Alt-N.  Complete instructions
  2581.   for how to create/edit data dictionaries can be found in the section
  2582.   "Creating Data Dictionaries".
  2583.   
  2584.   NOTE: This option will be available only if you have administrator or
  2585.   developer security.
  2586.   
  2587.   b) Edit
  2588.   
  2589.   The "Edit" option enables you to edit the data dictionary in memory.
  2590.   The quick key associated with this menu option is Alt-E.  Complete
  2591.   instructions for how to create/edit data dictionaries can be found in the
  2592.   section "Creating Data Dictionaries".
  2593.   
  2594.   NOTE: This option will be available only if you have administrator or
  2595.   developer security and if there is an active data dictionary.
  2596.   
  2597.   c) Print
  2598.   
  2599.   The "Print" option will print a formatted report containing all of the
  2600.   information stored in the data dictionary currently being edited.  This
  2601.   is useful for your reference, or for inclusion as part of your system
  2602.   documentation.
  2603.   
  2604.   NOTE: This option will be available only if you have administrator or
  2605.   developer security and if there is an active data dictionary.
  2606.   
  2607.   d) Load
  2608.  
  2609.  
  2610.                                     -45-                                  
  2611.  
  2612.  
  2613.   Grumpfish Report Generator                                 LOGPlus! v3.0
  2614.  
  2615.  
  2616.   
  2617.   The "Load" option enables you to load a previously saved data dictionary.
  2618.   The quick key associated with this menu option is Alt-L.
  2619.   
  2620.   When you select this option, you will be presented with a list of
  2621.   descriptions of previously saved data dictionaries (or an error message
  2622.   if none are found).  Use the arrow key to highlight the one you want,
  2623.   and press Enter.
  2624.   
  2625.   You will see two messages: "Loading Data Dictionary" and "Verifying
  2626.   Structure".  Assuming that there are no problems with this process, the
  2627.   description of the data dictionary will appear along the bottom row of
  2628.   the screen.
  2629.   
  2630.   e) Save
  2631.   
  2632.   The "Save" option enables you to save the data dictionary currently
  2633.   being edited. The quick key associated with this menu option is Alt-S.
  2634.   
  2635.   NOTE: This option will be available only if you have administrator or
  2636.   developer security and if there is an active data dictionary.
  2637.   
  2638.   When you select this option, you will be prompted to enter the filename
  2639.   (up to eight characters).  The default filename is "NEW" -- please feel
  2640.   free to change this to something else. Press Enter when you are finished
  2641.   typing the filename.
  2642.   
  2643.   The file extension .GRD will be added automatically.  If the filename
  2644.   already exists, you will be asked if you want to overwrite it.  The
  2645.   message "Saving Data Dictionary" will appear briefly, then disappear.
  2646.   
  2647.   Note that data dictionaries are automatically saved as READONLY. This is
  2648.   to prevent someone from accidentally deleting them via the DOS prompt.
  2649.   You will undoubtedly put a lot of work into creating a data dictionary,
  2650.   so you want your work to be protected.
  2651.   
  2652.   f) Save and Load
  2653.   
  2654.   The "Save and Load" option enables you to save the data currently being
  2655.   edited, then load it all in one fell swoop. The quick key associated
  2656.   with this menu option is Alt-A.
  2657.   
  2658.   NOTE: This option will be available only if you have administrator or
  2659.   developer security and if there is an active data dictionary.
  2660.   
  2661.   This option is most useful when you have created or edited a data
  2662.   dictionary, and wish to load it and start using it immediately.  Data
  2663.   dictionaries are not active until they have been loaded.
  2664.   
  2665.   Note that, unlike the "Save" option, you will only be prompted to enter
  2666.  
  2667.  
  2668.                                     -46-                                  
  2669.  
  2670.  
  2671.   Grumpfish Report Generator                                 LOGPlus! v3.0
  2672.  
  2673.  
  2674.   a filename if you have not changed the data dictionary name from the
  2675.   default ("NEW"). Assuming that you have changed the filename, your data
  2676.   dictionary will be saved to the same name (thus overwriting the earlier
  2677.   version of the same file), but this would be your intent anyway.
  2678.   
  2679.   g) Clear
  2680.   
  2681.   The "Clear" option will clear the data dictionary currently being edited.
  2682.   
  2683.   NOTE: This option will be available only if you have administrator or
  2684.   developer security and if there is an active data dictionary.
  2685.   
  2686.   h) Delete
  2687.   
  2688.   The "Delete" option allows you to delete a previously saved data
  2689.   dictionary file.
  2690.   
  2691.   NOTE: This option will be available only if you have administrator or
  2692.   developer security.
  2693.   
  2694.   When you select this option, you will be presented with a list of
  2695.   descriptions of previously saved data dictionaries (or an error message
  2696.   if there are none to be found).  Use the arrow key to highlight the
  2697.   data dictionary you wish to delete, and press Enter.
  2698.   
  2699.   
  2700.   IX.   GLOBALS MENU
  2701.   
  2702.   The Globals menu enables you to view, change, and optionally save a wide
  2703.   variety of global configuration options.  This allows you to tailor
  2704.   Grumpfish Reporter specifically to your needs.
  2705.   
  2706.   The options on this menu include: "Printer Setup"; "Case Sensitive";
  2707.   "Show Alias"; "Show Deleted Recs"; "Show Index Status"; "Date Format";
  2708.   "Company Name"; "Bells and Beeps"; "Toggle Video Mode"; "43/50 Line
  2709.   Forms"; "Wildcard for Search"; "Input File Path"; "Output File Path";
  2710.   "Large Index Warning"; "Ignore Datadict Path"; "Scanning Relations"; and
  2711.   "Save Globals".
  2712.   
  2713.   a) Printer Setup
  2714.   
  2715.   The "Printer Setup" option enables you to either change your installed
  2716.   printer, or any of your master print options (header/footer/etcetera).
  2717.   
  2718.   When you select this option, you will be asked if you want to select
  2719.   printer or change print options.  Highlight the desired option and
  2720.   press Enter.
  2721.   
  2722.   Select Printer
  2723.   
  2724.  
  2725.  
  2726.                                     -47-                                  
  2727.  
  2728.  
  2729.   Grumpfish Report Generator                                 LOGPlus! v3.0
  2730.  
  2731.  
  2732.   If you pick "Select Printer" and you have not yet selected a printer,
  2733.   you will be given a list of printers from which to select. Use the up or
  2734.   down arrows or the PgUp and PgDn keys to locate your printer. You may
  2735.   also type in the first few letters of your printer's name.  For example,
  2736.   if you have an HP Laserjet, press "H" to jump immediately to that group
  2737.   of printers. Once you have located your printer, press Enter to install
  2738.   it.
  2739.   
  2740.   You should then enter a printer description and port. The description
  2741.   should be anything that helps you to identify that particular printer.
  2742.   Printer ports supported by Grumpfish Reporter are LPT1-3 and COM1-4.
  2743.   
  2744.   If you pick the "Select Printer" and have already selected at least one
  2745.   printer, then you will be given the Defined Printers window. While you
  2746.   are in the Defined Printers window, you may press Ins to add a new
  2747.   printer or Del to remove the currently highlighted printer.  You may
  2748.   also press Alt-E to edit the description or port for currently
  2749.   highlighted printer.
  2750.   
  2751.   All printed output will be directed to the current default printer
  2752.   (i.e., the one with the checkmark next to it in the Defined Printers
  2753.   window). If you have only one printer installed, then obviously that
  2754.   will serve as the default. If you have more than one printer installed,
  2755.   you can select a default by highlighting the desired printer and
  2756.   pressing Enter.
  2757.   
  2758.   Print Options
  2759.   
  2760.   If you select "Change Options", you will be given the Printer Options
  2761.   window. The Print Options window is divided into three sections: Printer
  2762.   Options, Header Information, and Footer Information. You can use the Tab
  2763.   key to move quickly between these three sections. Press PgDn to save any
  2764.   changes you make, or press ESC to exit without saving changes.
  2765.   
  2766.   Page Length represents the total number of rows that can be printed on
  2767.   one page.  If you are using a laser printer, you should probably change
  2768.   this to 60.
  2769.   
  2770.   Left margin indicates where printed output should begin on the left
  2771.   side of the page.  This can be set between 0 and 49.  The default left
  2772.   margin is 5.
  2773.   
  2774.   Top Margin indicates where printed output should begin at the top of the
  2775.   page.  This can be set between 1 and 19.  The default top margin is 0.
  2776.   
  2777.   "Print total records" allows you to print the total number of records at
  2778.   the end of your report.  By default, this information is not printed.
  2779.   
  2780.   "Eject After Subgroups" allows you to force each new subgroup to be
  2781.   printed on a new page. (By default, this is not the case.) This applies
  2782.  
  2783.  
  2784.                                     -48-                                  
  2785.  
  2786.  
  2787.   Grumpfish Report Generator                                 LOGPlus! v3.0
  2788.  
  2789.  
  2790.   only when a sort order is active.
  2791.   
  2792.   "Column Spacing" represents the number of spaces to separate each of the
  2793.   columns on your report.  The default spacing is 1, and you can increase
  2794.   this as high as 19 if you wish.
  2795.   
  2796.   "Suppress Duplicate Values?" will suppress duplicate key values.  For an
  2797.   example of this, please refer back to Quick Start Part Two.  NOTE: This
  2798.   is only relevant when there is an active sort order, and can only be used
  2799.   to suppress values that serve as the primary sort key.
  2800.   
  2801.   "Show Record Count for Subgroups" allows you to see at a glance the
  2802.   number of records printed for each subgroup based on the primary sort
  2803.   order.  For an example of this, please refer back to Quick Start Part
  2804.   Two.
  2805.   
  2806.   "Double-Spaced Output" allows you to have a blank line between each row
  2807.   of data.  This is useful if you need to make annotations directly on the
  2808.   report.  By default, reports will be single-spaced.
  2809.   
  2810.   "Show % of Total for Subgroups" allows you to print the percentage of
  2811.   the total records in each subgroup.  This requires an active sort order.
  2812.   By default, percentages will not be printed.
  2813.   
  2814.   "Summary Report Only" allows you to suppress the printing of detail
  2815.   records.  If you specify a summary report, the only items printed will
  2816.   be the report header, footer, subtotals for each subgroup, and grand
  2817.   totals.  Note that it makes little sense to print summary reports if you
  2818.   do not have subgroups (i.e., an active sort order).
  2819.   
  2820.   "Auto-compress" determines whether Grumpfish Reporter will force your
  2821.   printer to compressed mode for reports wider than 80 columns (110
  2822.   columns for landscape, 140 columns for landscape legal).  By default,
  2823.   auto-compress is turned on.  However, you might want to turn it off if
  2824.   you have a printer that will accommodate wide paper.  Naturally, this
  2825.   feature will not do anything if your printer doesn't support compressed
  2826.   mode.
  2827.   
  2828.   "Printer port" determines the port to which to send the report.
  2829.   Grumpfish Reporter supports LPT1-3 and COM1-4.
  2830.   
  2831.   "Orientation": If you are using a laser printer, you will be given the
  2832.   option of changing the page orientation.  "P" is Portrait, which is
  2833.   standard 8 1/2" width, 11" length.  "L" is Landscape, which is 11"
  2834.   width, 8 1/2" length.
  2835.   
  2836.   "Lines per inch": If you have a printer that supports 8 lines per inch
  2837.   (LPI), you will be given the option of switching between 6 and 8 LPI.  8
  2838.   LPI allows you to cram more data onto the printed page.
  2839.   
  2840.  
  2841.  
  2842.                                     -49-                                  
  2843.  
  2844.  
  2845.   Grumpfish Report Generator                                 LOGPlus! v3.0
  2846.  
  2847.  
  2848.   Header/Footer Information
  2849.   
  2850.   The next two sections of this window are devoted to Header and Footer
  2851.   Information, respectively.  The header and footer are each composed of
  2852.   four lines.  Each of those four lines is divided into three sections:
  2853.   Left, Center, and Right.  Items in the Left section will be printed
  2854.   flush against the left margin.  Items in the Center section will be
  2855.   centered horizontally on the row.  Items in the Right section will be
  2856.   printed flush against the right margin.
  2857.   
  2858.   These items can contain either stock insertion items or actual text.
  2859.   Stock insertion items are things that you would ordinarily like to have
  2860.   as part of your report header/footer, but do not necessarily want to
  2861.   retype each time.  You can insert the following stock items anywhere in
  2862.   the header or footer by pressing F10:
  2863.   
  2864.   - Date
  2865.   - Time
  2866.   - Company Name
  2867.   - Page Number
  2868.   - Report Description
  2869.   - Query Description
  2870.   
  2871.   You may also insert free-format functions by selecting "<FUNCTION>". It
  2872.   can be any function that is available to the application.
  2873.   
  2874.   The following text enhancement codes may also be inserted anywhere in
  2875.   the header or footer by pressing F10:
  2876.   
  2877.   - Bold On
  2878.   - Bold Off
  2879.   - Underscore On
  2880.   - Underscore Off
  2881.   - Italic On
  2882.   - Italic Off
  2883.   - Compressed On
  2884.   - Compressed Off
  2885.   
  2886.   WARNING: If you turn on a text enhancement, you must turn it back off or
  2887.   it will remain on for the duration of your report!
  2888.   
  2889.   The default report header is comprised of the following:
  2890.   
  2891.   Line 1:   Date (flush left), Company Name (centered), Page # (flush right)
  2892.   Line 2:   Time (flush left)
  2893.   
  2894.   "Lines between header and column headings" represents the number of
  2895.   blank lines to insert between the end of the report header and the
  2896.   beginning of the column headings.  The default value is 1, though you
  2897.   can increase it to as many as 9.
  2898.  
  2899.  
  2900.                                     -50-                                  
  2901.  
  2902.  
  2903.   Grumpfish Report Generator                                 LOGPlus! v3.0
  2904.  
  2905.  
  2906.   
  2907.   "Lines between bottom of data and footer" represents the number of blank
  2908.   lines to insert between the end of the data and the beginning of the
  2909.   report footer.  The default value is 1, though you can increase it to as
  2910.   many as 9.
  2911.   
  2912.   TIP: Consider setting up a basic header and footer that can serve as a
  2913.   template for all of your reports.  Then if you need to insert specific
  2914.   information for one particular report, you will not have to bother
  2915.   reconfiguring the entire header or footer.  Instead, you can simply
  2916.   insert the desired new text.
  2917.   
  2918.   Remember that whenever you change print options, the new settings will
  2919.   remain in effect until you either load a previously saved report or
  2920.   change the options again.
  2921.   
  2922.   b) Case Sensitive
  2923.   
  2924.   The "Case Sensitive" option is a toggle that determines whether queries
  2925.   should be case sensitive or not.  It also applies to sort order -- i.e.,
  2926.   if case sensitivity is off, then all character sort fields will be
  2927.   automatically converted to upper-case.
  2928.   
  2929.   By default, queries will not be case sensitive. For example, if you are
  2930.   checking for a field that contains the word "BASEBALL", a case
  2931.   insensitive query will also find "Baseball", "baseball", and any other
  2932.   permutation of the word.  If it is paramount that the query only find
  2933.   the word "BASEBALL", then you should toggle Case Sensitivity on.
  2934.   
  2935.   If a checkmark appears next to "Case Sensitive", that indicates that
  2936.   queries will be case sensitive.
  2937.   
  2938.   c) Show Alias
  2939.   
  2940.   The "Show Alias" option is another toggle that determines whether
  2941.   database aliases should be shown throughout Grumpfish Reporter.  By
  2942.   default, aliases will be shown.
  2943.   
  2944.   This is purely a matter of aesthetics.  Some people do not like having
  2945.   to look at the database aliases.  Here is a quick example of the
  2946.   difference:
  2947.   
  2948.   Showing Aliases
  2949.   
  2950.   SAMPLE->TITLE
  2951.   SAMPLE->AUTHOR
  2952.   SAMPLE->KEYWORDS
  2953.   
  2954.   Not Showing Aliases
  2955.   
  2956.  
  2957.  
  2958.                                     -51-                                  
  2959.  
  2960.  
  2961.   Grumpfish Report Generator                                 LOGPlus! v3.0
  2962.  
  2963.  
  2964.   TITLE
  2965.   AUTHOR
  2966.   KEYWORDS
  2967.   
  2968.   If a checkmark appears next to "Show Alias", that indicates that
  2969.   database aliases will indeed be shown.
  2970.   
  2971.   d) Show Deleted Recs
  2972.   
  2973.   The "Show Deleted Recs" option is another toggle that determines whether
  2974.   deleted records should be displayed when you view data on-screen.  By
  2975.   default, deleted records will be shown.
  2976.   
  2977.   If a checkmark appears next to "Show Deleted Recs", that indicates that
  2978.   deleted records will indeed be shown.
  2979.   
  2980.   e) Show Index Status
  2981.   
  2982.   The "Show Index Status" option is another toggle that determines whether
  2983.   the omnipresent status bar should be displayed.  By default, the status
  2984.   bar will be shown.
  2985.   
  2986.   It is our recommendation that you leave this option set on for your own
  2987.   benefit.  The status bar plays an important role in keeping you apprised
  2988.   of the status of executing queries and the like. It is true that by
  2989.   stifling the status bar, the process will be quicker because Grumpfish
  2990.   Reporter does not need to take the time to display the status bar.
  2991.   However, it will seem like an eternity if nothing is being displayed on
  2992.   the screen -- take our word for it.
  2993.   
  2994.   If a checkmark appears next to "Show Index Status", that indicates that
  2995.   the status bar will be shown.
  2996.   
  2997.   f) Date Format
  2998.   
  2999.   The "Date Format" option allows you to change the way that Grumpfish
  3000.   Reporter displays and prints dates.  The following date formats are
  3001.   available:
  3002.   
  3003.   - mm/dd/yy (default)
  3004.   - yy.mm.dd
  3005.   - dd/mm/yy
  3006.   - dd.mm.yy
  3007.   - dd-mm-yy
  3008.   - yy/mm/dd
  3009.   - mm-dd-yy
  3010.   - mm/dd/yyyy
  3011.   - yyyy.mm.dd
  3012.   - dd/mm/yyyy
  3013.   - dd.mm.yyyy
  3014.  
  3015.  
  3016.                                     -52-                                  
  3017.  
  3018.  
  3019.   Grumpfish Report Generator                                 LOGPlus! v3.0
  3020.  
  3021.  
  3022.   - dd-mm-yyyy
  3023.   - yyyy/mm/dd
  3024.   - mm-dd-yyyy
  3025.   
  3026.   Use the arrow keys to select the desired date format, and press
  3027.   Enter to select it.
  3028.   
  3029.   g) Company Name
  3030.   
  3031.   This option enables you to change the company name printed on reports.
  3032.   Type in the desired company name, and press Enter.
  3033.   
  3034.   h) Bells and Beeps
  3035.   
  3036.   The "Bells and Beeps" option allows you to enable or disable sound.  By
  3037.   default, sound is disabled. If sound is enabled, Grumpfish Reporter will
  3038.   give you tones in conjunction with error and wait messages.  Some people
  3039.   like it, and some don't, which is why we let you turn it off.
  3040.   
  3041.   If a checkmark appears next to "Bells and Beeps", that indicates that
  3042.   Grumpfish Reporter will use sound.
  3043.   
  3044.   i) Toggle Video Mode
  3045.   
  3046.   The "Toggle Video Mode" option allows you to switch between standard 25-line
  3047.   video and 43/50-line video.  If you have EGA or VGA video, you may wish
  3048.   to take advantage of this option so that you can get more data on screen
  3049.   at once. By default, Grumpfish Reporter starts up in 25-line mode.
  3050.   
  3051.   TIP: If you toggle the video mode and then save your global information,
  3052.   Grumpfish Reporter will put you in the desired video mode when you fire
  3053.   it up again.
  3054.   
  3055.   j) 43/50 Line Forms
  3056.   
  3057.   The "43/50 Line Forms" option is similar to "Toggle Video Mode".
  3058.   However, it is restricted to the form painter.  If you have this set on,
  3059.   you will automatically switch to 43/50 line mode upon entering the form
  3060.   painter. The reasoning behind this is that you can therefore have longer
  3061.   forms. NOTE: This option is meaningless without either an EGA or VGA
  3062.   video adapter.
  3063.   
  3064.   If a checkmark appears next to "43/50 Line Forms", that indicates that
  3065.   the option is enabled.
  3066.   
  3067.   k) Wildcard for Search
  3068.   
  3069.   This option allows you to specify a file specification to limit files
  3070.   available for selection. (By default, Grumpfish Reporter will search for
  3071.   all files with the .DBF extension.) For example, if you only want to
  3072.  
  3073.  
  3074.                                     -53-                                  
  3075.  
  3076.  
  3077.   Grumpfish Report Generator                                 LOGPlus! v3.0
  3078.  
  3079.  
  3080.   select files beginning with the word DEPT", you could specify
  3081.   "DEPT*.DBF" as the wildcard for search. This can also save the day if
  3082.   all of your database files have an extension other than .DBF.
  3083.   
  3084.   l) Input File Path
  3085.   
  3086.   This option allows you to determine where to save and load any *.GR?
  3087.   files (e.g., reports, forms, queries, and data dictionaries). If you
  3088.   do not specify an input file path, all of these Reporter files will be
  3089.   saved to and loaded from the current DOS directory.
  3090.   
  3091.   m) Output File Path
  3092.   
  3093.   This option allows you to determine where to create output files,
  3094.   including reports, forms, databases, spreadsheets, ASCII files, and
  3095.   crosstabs. If you do not specify an output file path, these files will
  3096.   be created in the current DOS directory.
  3097.   
  3098.   n) Large Index Warning
  3099.   
  3100.   This option enables a warning in the event that you are about to create
  3101.   an index on a database of greater than 50,000 records (which can be a
  3102.   time- consuming process).  This applies either when processing queries
  3103.   or setting up relations without using existing indeces.  (Note to
  3104.   developers: The number of records can be changed by modifying the
  3105.   INDEX_WARNING_RECCOUNT manifest constant in the GR.CH header file.)
  3106.   
  3107.   If a checkmark appears next to "Large Index Warning", that indicates
  3108.   that warnings are enabled.
  3109.   
  3110.   o) Ignore Datadict Path
  3111.   
  3112.   Data dictionaries store the path for databases and indeces. This option
  3113.   allows you to ignore those paths.  This is useful if you have the files
  3114.   in two places for testing purposes.
  3115.   
  3116.   If a checkmark appears next to "Ignore Datadict Path", that means that
  3117.   the paths will be ignored.
  3118.   
  3119.   p) Scanning Relations
  3120.   
  3121.   Whenever you open related databases -- manually, via a data dictionary,
  3122.   or as part of a presaved report or query -- Grumpfish Reporter looks at
  3123.   this option to determine how to build the relations between those files.
  3124.   If a checkmark appears next to "Scanning Relations", that means that all
  3125.   relations will be scanning rather than one-to-one.
  3126.   
  3127.   The difference between one-to-one and scanning (one-to-many) relations
  3128.   is that one-to-one relations only find the first related record in the
  3129.   child database, while a scanning relation will find all related records.
  3130.  
  3131.  
  3132.                                     -54-                                  
  3133.  
  3134.  
  3135.   Grumpfish Report Generator                                 LOGPlus! v3.0
  3136.  
  3137.  
  3138.   
  3139.   To illustrate this difference, let's look at a brief example. We have a
  3140.   customer file that contains the following three customer IDs: JACK, JOE,
  3141.   and JON.  We also have an order file that contains the following orders:
  3142.   
  3143.     Date      Customer
  3144.   06/01/94      JACK
  3145.   06/03/94      JON
  3146.   06/04/94      JOE
  3147.   06/05/94      JACK
  3148.   06/08/94      JACK
  3149.   06/10/94      JACK
  3150.   06/16/94      JON
  3151.   06/17/94      JOE
  3152.   06/20/94      JOE
  3153.   
  3154.   If you open the customer and order databases using a scanning relation
  3155.   and then sort on customer ID, your output will resemble the following:
  3156.   
  3157.   Customer      Date
  3158.     JACK      06/01/94
  3159.     JACK      06/05/94
  3160.     JACK      06/08/94
  3161.     JACK      06/10/94
  3162.     JOE       06/04/94
  3163.     JOE       06/17/94
  3164.     JOE       06/20/94
  3165.     JON       06/03/94
  3166.     JON       06/16/94
  3167.   
  3168.   If you open the customer and order databases using a non-scanning
  3169.   (one-to-one) relation, you will only get the first order for each
  3170.   customer, like so:
  3171.   
  3172.   Non-Scanning (One-to-One) Relation
  3173.   
  3174.   Customer      Date
  3175.     JACK      06/01/94
  3176.     JOE       06/04/94
  3177.     JON       06/03/94
  3178.   
  3179.   q) Save Globals
  3180.   
  3181.   The "Save Globals" option allows you to save the current state of both
  3182.   all global options and your defined printers so that you can use them in
  3183.   the future without having to reset everything.  If you select this
  3184.   option, the message "Saving global info" will appear briefly, then
  3185.   disappear. The files GR.CFG (global configuration) and GR.PRT (printer
  3186.   configuration) will be saved in the same directory from which you loaded
  3187.   GR.EXE.
  3188.  
  3189.  
  3190.                                     -55-                                  
  3191.  
  3192.  
  3193.   Grumpfish Report Generator                                 LOGPlus! v3.0
  3194.  
  3195.  
  3196.   
  3197.   If you select this option, and either GR.CFG or GR.PRT already exists,
  3198.   you will be asked to confirm that you wish to overwrite them.
  3199.   
  3200.   *** end of file GR.DOC ***
  3201.  
  3202.  
  3203.  
  3204.  
  3205.  
  3206.  
  3207.  
  3208.  
  3209.  
  3210.  
  3211.  
  3212.  
  3213.  
  3214.  
  3215.  
  3216.  
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.  
  3231.  
  3232.  
  3233.  
  3234.  
  3235.  
  3236.  
  3237.  
  3238.  
  3239.  
  3240.  
  3241.  
  3242.  
  3243.  
  3244.  
  3245.  
  3246.  
  3247.  
  3248.                                     -56-                                  
  3249.